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PREFACE 



This manual is a guide to program listings for people who maintain the Overlay Linkage 
Editor or Checkpoint/ Restart features for the IBM System/3 Model 10 Disk System and 
the Overlay Linkage Editor feature for the IBM System/3 Model 6. 

Before using this manual, the reader should be familiar with the operating procedures 
contained in the IBM System/3 Overlay Linkage Editor Reference Manual, GC2 1-7561 , 
and the IBM System/3 Model 10 Disk System Control Programming Reference Manual, 
GC21-7512. 



SYSTEM/3 MODEL 8 

The System/3 Model 8 is supported by System/3 Model 10 Disk System control 
programming and program products. The facilities described in this publication for 
the Model 10 are also applicable to the Model 8, although the Model 8 is not 
referenced. It should be noted that not all devices and features which are available on 
the Model 10 are available on the Model 8. Therefore, Model 8 users should be familiar 
with the contents of IBM System/3 Modal 8 Introduction, GC21-51 14. 



RELATED PUBLICATIONS 

• IBM System/3 Card and Disk System Components Reference Manual, G A2 1 -91 03. 

• IBM System/3 Disk Systems System Con trol Program L ogic Manual, S Y2 1 -0502. 

• IBM System/3 Disk Systems Data Management and Input/Output Supervisor 
Program Logic Manual, SY21 -051 2. 

• IBM System/3 Model 10 Disk System Operator's Guide, GC21-7508. 



HOW THIS MANUAL IS ORGANIZED 

This manual has two parts: Overlay Linkage Editor and Checkpoint/ Restart. 

Part I includes: 

Introduction: general information about the characteristics of the program, functions 
of the program, and input descriptions. 

Program Organization: an operational diagram, storage maps, and flowcharts. 

Data Areas: contents and formats of data areas used by two or more routines. 

Diagnostic Aids: various aids that help diagnose problems. 

Part II includes: 

introduction: general information about the program. 

Program Organization: functional considerations, operational diagrams, storage maps, 
linkage considerations, and flowcharts for both the Checkpoint and Restart programs. 

Data Areas: contents and formats of data areas used by Checkpoint and Restart. 
Diagnostic Aids: various aids that help diagnose problems. 
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SECTION 1. INTRODUCTION 



The Overlay Linkage Editor enables the user to influence 
the determination of overlays for his programs. An auto- 
matic determination of overlays is also provided. 



Each R module consists of External Symbol List (ESL) 
fields (packed five to a 64-byte S-type record) and text 
records. An END record follows the R modules. A/* 
record must be the last record in the compiler output. 



Options Record: The options record tells the Overlay 
Linkage Editor what functions to perform. The options 
record must be the first record in $WORK. Figure 3 
shows the format of the options record. 



OPERATING CHARACTERISTICS 

The Overlay Linkage Editor can be entered two ways: 
directly from a language processor (compiler), or as a 
user-called program. The functions and method of opera- 
tion are different depending on whether the entry is via 
the compiler entry or the user entry. 



Compiler Entry 

When entered directly from a language processor 
(Figure 1), the Overlay Linkage Editor can perform any 
or all of the following functions: 

1. Catalog an R module into an object library on disk. 

2. Punch an R module into cards. 

3. Link R modules into an object program and catalog 
the program into an object library on disk and/or 
punch it into cards. 



R module: The R module consists of ESL fields packed 
into S-type records, text records, and an END record. 
Each 64-byte S-type record can contain up to five, 12-byte 
ESL fields. The S-type record must be hex J 00's after the 
ESL fields. 

R modules are described in the IBM System/3 Over/ay 
Linkage Editor Reference Manual, GC2 1-7561 . 



Output From Compiler Entry 

Output from the Overlay Linkage Editor is specified by 
the options record in $WORK. The R module in $WORK 
can be punched into cards and/or cataloged into the object 
library. If link edit is specified, an module is built from 
the input R module. The module is then punched into 
cards and/or cataloged into the object library. 

A storage map and cross reference list is printed unless the 
options card specifies otherwise. 



User Entry 

The Overlay Linkage Editor can be loaded by using a 
// LOAD $OLINK OCL statement. The user must supply 
control statements. 



Input for Compiler Entry 

Input to the Overlay Linkage Editor is in the $WORK file 
on disk. Each record in $WORK is 64 bytes long 
(Figure 2). The first record must be the options record; 
R modules follow the options record. 



Input for User Entry 

Input for the user entry is described in the IBM 
System/3 Over/ay Linkage Editor Reference Manual, 
GC21-7561. 
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Figure 1. Overview of Overlay Linkage Editor Compiler Entry 
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(See Figure 3.) 
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Figure 2. Input to Compiler Entry 
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Attributes 


Core 
Size 


RType 


Type 
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Flag 
byte 
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Attributes: This two-byte field describes the linked object program built by the Overlay Linkage Editor. 



Bit 



Byte 1 
01234567 
Ixxxxxxx 
Oxxxxxxx 
xlxxxxxx 
xxlxxxxx 
xxxlxxxx 
xxxxlxxx 
xxxxxlxx 
xxxxxxlx 
xxxxxxxl 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 



Byte 2 
01234567 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
xxxxxxxx 
Ixxxxxxx 
xlxxxxxx 
xxlxxxxx 
xxxlxxxx 
xxxxlxxx 
xxxxxlxx 
xxxxxxlx 
xxxxxxxl 



Permanent entry 

Temporary entry 

Inquiry 

Inquiry Evoking 

Must run dedicated 

Requires source 

Deferred mounting 

PTF applied (not used by Overlay Linkage Editor) 

Overlay program 

System input dedication 

Checkpoint program 

Direct source read 

Macro processor allowed 

Reserved 

FORTRAN Common 

Reserved 

Reserved 



Main Storage Size: This is the amount of storage {in 1/4K increments) necessary for execution of the 
object program. 

Example = Hex'12' = 18{Hex'12'| X 256 (1/4K) =4608 Bytes 

R-Type: This byte specifies the disposition of the R. module in $W0RK. 

Bit 01234567 

Ixxxxxxx Punch into cards 

xlxxxxxx Catalog into object library on R1 

xxlxxxxx Catalog into object library on R2 

xxxlxxxx Catalog into object library on Fl 

xxxxlxxx Catalog into object library on F2 

xxxxxlxx Catalog as Retain-R in library 

xxxxxxlx Catalog as permanent entry in library 

xxxxxxxl Catalog into object library on program pack 

00000000 No R module 



Figure 3 (Part 1 of 2). Options Record 



O-Type: This byte specifies the disposition of the linked object program and the type 
of printed output from the Overlay Linkage Editor. 

Bit 01234567 

Ixxxxxxx Punch object program into cards 

xlxxxxxx Catalog object program into object library on R1 

xxlxxxxx Catalog object program into object library on R2 

xxxlxxxx Catalog object program into object library on F1 

xxxxlxxx Catalog object program into object library on F2 

xxxxxlxx Do not print core map 

xxxxxxlx Do not print cross-reference list 

xxxxxxxl Catalog object program into object library on program pack 

00000000 No linked output. (If neither an R or an O module is specified, 
an O is cataloged on the program pack.) 

User Pack: This byte specifies the pack where user routines are stored. The Overlay 
Linkage Editor will search this pack first when resolving EXTRNs to modules whose 
names do not begin with $. If the EXTRN name is not found on this pack, the 
program pack is searched. 



Bit 



01234567 
Ixxxxxxx 
xlxxxxxx 
xxlxxxxx 
xxxlxxxx 
xxxxlxxx 

XXXXX111 



Reserved 
Search R1 
Search R2 
Search F1 
Search F2 
Reserved 



Flag Byte: This byte passes information to the Overlay Linkage Editor. 



Bit 01234567 
11110000 
000000x1 
0000001 x 
000001 xx 
00001 xxx 



Reserved 

Link edit address in bytes 14 and 15 

Catalog Load Module as Retain-R in -library 

Sequence field name given in bytes 16 through 21 

Print messages 



Link Address: These two bytes specify a link edit address. If bit 7 of the flag byte is 
not on, the Overlay Linkage Editor links the load module to the end of the supervisor. 

Sequence Field Name: Name put in sequence field. If not specified, ESL will be used. 



Figure 3 (Part 2 of 2). Options Record 
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Output From User Entry 

Output of the Overlay Linkage Editor for user entry is an 
object program cataloged into an object library and/or 
punched into cards {Figure 4). 



A storage map and cross reference list are printed depend- 
ing on the MAP parameter of the // OPTIONS card. 
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Figure 4. Overview of Overlay Linkage Editor User Entry 



The Overlay Linkage Editor is divided into self-overlaying 
routines. The sequence in which routines are loaded and 
which routines are used depends on whether the compiler 
entry or the user entry is used and which functions are 
requested. Figure 5 shows an operational diagram of the 
Overlay Linkage Editor program. Storage maps of the 
compiler interface and the user interface are shown in 
Figures 6 and 7. 



SECTION 2. PROGRAM ORGANIZATION 



Data Movement c 
Control Flow 



C> 
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Functions — *■ 

Branches ■*- 

Input Data Areas »~ 
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Routines Called *- 
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i 
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+ If //END 

COMMON 
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Chart ID- Routine is in this manual 



*1 



Routine is in IBM System/3 Disk 
Systems System Control Program 
Logic Manual, SY21-0502 

Routine is in IBM System/3' Disk 
Systems Data Management and 
input/Output Supervisor Logic 
Manual, SY21-0512 



(Next Phase) 



Figure 5 (Part 1 of 3). Operational Diagram Legend 
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• Load* up to 266 MCtrxi at a time according 
10 a binary relative sector number 

XR 2 -Poet Open Diik DTF 



Externa! Routines 



DUk IDS 
Disk WeK 




SOLMSG Chart AR Eclry P^W ^i W*:< f 

Error Meivt« pB -n| 
• Print error meMage 
TN. Error Code 



ExierfMl Routine* — — 



SCAM AN Compiler Accra. Mel hod 



^ 



Figure 5 (Part 3 of 3). Operational Diagram 
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• ***A 1********1 

FNfpg 

•a************4 



***** pi •*»*»***** 
*ATIOCA^P r OPfM* 
**WOP" ^ rroriPCF* 
*ioao ftPftfn A?fn* 

«01.Ffi * 



82 



•*aa*B?*****a***a 

* * 
•F^TCH 10LTN2 TO* 
*R?AT> H DBCK OH *<- 

* FIHD INCLODE ♦ 



icnon v 

*««*«(7 -)**«■*•*♦* 
« TNTTALT7E 

* TOfllDN, PIVP 

♦ 'OT.TN1, SOLIN2, 

*0f.T>H 



**** | 

♦ •♦pi •••«**■**•< 
* PFAP fPOl 



I 

[ AR/01/A1 
****C2********« 
'■EXIT TO *OLTH2 * 



CA"} •• >* C^PT ov toe * 

• . .* * DFVICS • 



I * * 

• * 



. * a * . * p ? * 

•. BO"'"'' .- >» °2 



* 10 

I 



CUTEGORY 
•.STATEBEHT.* 



fYES .* GROUP 
-*. STATKEST 



nes 



SQUATS *. 

stSteheht .♦ 



EVD *. N3 
STUTEHSHT —•> 



INK980 AT/Ol/M 

■ • **-pO **••*•**** 

'S0LF8 f 



ISSUE HALT 



L->* D1 > 



* T>F.VT" * 



I 

"1 », 



*FS *fft , :h tOl^lM ^rv* 

, ■>* I'll hdl": * 

A • S^ATFHFNr * 



.I!LJ 



AP/01/A1 

,**«,12********* 

* * 

• vvt- to E(,!.TJI1 • 



■PETCH I0LIJf3 TO" 
' PROCESS * 

' STATEHEST * 



H0/01/A1 
*« **H 1******** * 
'ElfTT TO J01.T*1 * 



Chart AA. User Entry Phase 1 ($OLIWK) 
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****ai ********* 

• * 

* BITTER * 



***+ 

* * 

* B1 *-> 

* * 

T-SK125 

B1 



-• PHASE *. TBS 

'. STiTEHEWT .+ 



TMK120 



.* STSTW •- TES 
•>*. OK .• 

•. .+ 



* BO • EQ 

| I ••*••. 

.+. tHIC»00 .*. 

CI +. C2 *. 

.* », .* *. 

.* OPTIONS *. TES .• STSTAI *. TES 

'. STATBUBHT .•-- - — >*. OK .*— — 



♦ • 

>• dl • 



.* inclodb *. tbs 
*. stateheet .* 1 

*. .* I 

*. .• I 

*. .* 7 



• G3 * 



.* ** TES 

*. CATEGORY .•"-. 

•.STATEBBRT.* 
*. .* 



.* *. 

.* GROOP *- TBS 
•. STATEMENT .*-- — > 



.:quate 

•. STATEMENT .» > 



.« EQUATE •. tis 



HO 



HI • . 



TWK13S 



BHD *. YES T • FETCH PHASE * 



*. STATEMENT .•■ 
• . •• 

• • -• 



■>» SOLIN3 



• J1 *-> 



at/ovai 



MOLFP 



* TSSO* HALT • 



AO/01/fcl 

» j2**«****** 

* • 

• BUT TO S0LTB3 • 



*****B3"»* 

• • 
*(OVE IHFO FBOd * 
■>**HiSE TO 10MMOM* 



•****C3 *•*****•«• 



• DOVE IBFG FBQt! • 
■>*PHIS* TO tOHUOll* 



**•* 
IHK110 

*+*D3* ••*•***•*•* 

BE1D NUT * 
^ITBHBHT 



STAl 
FEOH ST SI 8 



IKK115 



B3 



.• CORHENT • , 
CAHD 



HO 



IBH120 



♦PRIIfT STATEMENT* 
->* ON L05 OBVICI •—-. 

: : I 

■**• 

• * 

• D3 • 

• * 
■*■■ 



F3 


* 


,* 




.• K 




* . MODULE 


*. 




*. 




■ m 


* 


* 


T 


**•* | 




* * 




• G3 *-> 




• • 




• *** 




ISK130 V 





•PRIST STATEMENT* 
~ OH LOG DETICE ~ 



: i 

*•*****••**•*•*** T 



■■#• 

• • 

• B1 • 

• • 
*■*• 



><J3< 
•TCP 

khib: 



• FETCH PHASE • 
12 • 



AG/0 1/11 
•*«*H3*«b****** 



L->* D 3 * 

• ■ 



Chart AB. User Entry Phase 2 ($OLIN1 1 
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'12********* 

* 
ENTER * 



****»B 2 ********** 

* 4 

* GET DISK * 

* ADDRESSES OF * 

* BOBK PILES * 



YNX1Q0 

•****C2********** 



INITIALIZE 
LOHHOH 



***************** 



«*» D 2********< 

BEAD SMOfiK 

i 

**************** 



ESROfi 
IN SBORK 



111X530 AI/01/A1 

•*»*• E3** ******** 
*|OLBR 

— >*" 

• ISSUB HALT 



THX125 » 

**+**? 2*********** 

* * 
•SST IBFO. PRQfl * 

* dptidb ib * 

* LOHHOH * 



i***F3********* 



IHI155 

*****Q2* ******** 



•DETEBBIBE BEIT * 
•SECTOB IB HfOBK* 



.* fi *. 

rlO DO IE 
♦-BBQUESTBD.* 



* SET TO CALL * 

* SOLBO AS BEXT *- 

* PHASB * 



**»**# 2**** ****** 

* a 

* SET TO CALL * 
■>• IOLAF AS HBXT » 

» PHASE * 

* * 
***************** 



*PIBD SYSLOG FOR* 
--iIHTI"- 
■>* SAVE CU/SEC 



PBIBTEB AND * 



T8X13S 
— >*CALL NEXT PHASE* 



Chart AC. Compiler Entry Phase ($OLYNX) 



**** an ********* 

KIT to $o: 

OH SOLAF 



EXIT TO SOL BO * 
SOI 
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• *** 

* * 

* B3 * 

* » 



0LB070 



• TEST KUTIULLY + 

• E)CCIUSI?E + 
•ATTRIBUTES AHO • 

• HALT IF KR&OR • 



0LBC05 V 

•DETEftrtlKE TYPE * 
•OF OUTPUT, cIND* 
•Q CODE OF TO" • 
• PAC(t * 



B3 



. * PUNCH O •. >fO 
'. NCDULB ONLY .* — ■ 



♦ YES 
< 



*****C3 
•rOLFTE 



•>• CATALOGUE ♦ 

* HODULE • 



V AE/Ot/AI J QI80UQ 
********** 



•PUNCH MODULE 



• I .• 



PUSCH *. 
KOOULE 



• •** 
• D3 •-> 



SEE NOTE 1 
•*»*D3*****a»*» 

S5SPRJ 



OLBQ25 



PDNCR E 
ONLY. 



fr AE/01/A1 

*****pi**«+****** 

•SOLFTP • 



•PUNCH h SODITLE • 
* • 

♦*•*•*•********** 



OLBO30 



G1 



40/02/4 1 
a* «** £2 •*••****•• 

• FOLOOO ♦ 

■>■ CATfcLOG&E R • 

• flDDULE + 

• * 
•it*************** 



F2 •. 

t 4 

PUNCH B 

* „ * 
* SO 



.* LTNK *. SO 


*. HEQCTIRED .• -i 


•■ -* 1 


-• 


• . .* V 


• YES •••* 




* * 




• D3 • 




* • 




**** 




AF/01/A1 


a»**H1********* 


* * 


• EIIT TO fOLAF + 


* * 


******* 


>**•*•** 



NOTE 1 : 

SB3 IBH SYSTEH/3 DISK SYSTEHS 
SYSTEH COBTBOI VROGkkti LOGIC 
iUHtTAL SY21-0502. 



Chart AD (Part 1 of 2). Library Control Phase ($OLBO) 
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FOLOOO 

• ***A 1********* 

• BHTEfc < 

• < 
*************** 



roLdoo 

* a 

* CHECK *!»D SET • 
*PACK UfTESLOCKS* 



a***************< 



CAS HE 
CATALOG 



**C2aa******** 



***aapj aa* a ****** 

* * 

* GiiAB COHS FOE * 

* BUFFERS. READ • 

* VOLUSE LABEL * 



vaaapj********* 

* • 
— >'KET0R]l TO IOLBO* 

* * 

TO PUNCH BOBULE 



L->* 61 « 

**** 



OBJECT 

LIBRARY 

EXIST 



****B2** ****** a 

* EXIT TO « 
■>* HALT/SYSLOG * 

* HALT 67 * 
a****««*****#*a 



• CHECK FOR » 
♦AVAILABLE SPACE* 

• IK LIBRARY C » 

• DISECTOiY * 
a a 
***************** 



FOLSOO 

**a**G1 ********** 

* CHECK FOR * 
•DUPLICATE HUB » 

* B DELETE, IF * 

* POSSIBLE » 



* a*»*Ri ********** 

* IF POTTISG IS * 

* PBFKAHENT * 

* EflTRY, DELETE * 

* ALL TEMPS 5 • 

* FIND BEST FIT * 
a**************** 



a** **J1 ********** 
a * 

* FILL C/S/D TH * 

* DIB. IF BEST * 



' G2 ' 
« i 

• *** 



FOL055 



POT INTO 
LIBRARY 



***************** 



FOLoes 

*»*H 2* ********** 

• UPDATE VOLOBE < 
LABEL LIBRARY 
* INFOHHATIOH * 

***************** 



#OL095 



raj 2****** ****** 



UPDATE 
DIB ECTOR Y 



***************** 



FOL020 1 

***K1 ************ 



READ INPUT 
FILE 



• *** 

i ■ 
' G2 * 
i i 

• •** 



a* ******* a***** 



Chart AD {Part 2 of 2l. Library Control Phase ($OLBO) 
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fTPOOO 

• EHTE8 < 



**»*tB1********** 

• BUILD // COPT * 

• * 



fipoao 

**»** C 1 ********** 

♦LOCATE // PUICH* 

* DEVICE. tOlO * 

* ST$-PB«CH * 

* NODDLE • 



• *** 

• ♦ 

• Dl •-> 

• * 

•»***D1 ********** 

• * 

• PDBCH // COPT * 



Cll 



P1P05O 

**•**£ 1 ********** 

• • 

•BtlXLD , B« CUD • 

• POMCH CUD • 



rtpoto 



FILL DISK 
BDTPEHS 



•••**•*******•*•• 



rtP07s 

•****G1 ********** 



• PUBCH OBJECT 

* BOOOLB 



PTPH5 

•*»**fl^ ********** 

• • 

• PU&CH // CEUD • 

• ciab • 



.* *. 

,* PDHCB *. TBS 

I10LTIPLB .* 

*. NODULES .* 

*. .* 

*. .• 



->* BE-iHiTmrzE ♦ 



L 



**** 

>* Dl ♦ 



****1M********* 

* BETDBB TO * 
> CftLLES * 



Chart AE. Punch Phase <$OLFTP) 
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nmopo 



BUTFP ' 
****«**•■*■•■*** 



*****£ 1*********« 

*Trvr TNCLOOTPR ■ 

• QPTTflTZPO RFR * 
•ASSIES FOB BnT«* 

• TIB 6 SPO ITST * 

• nrsr t/0 * 
***************** 

• ••* 

• C1 *-> 

• **• 
AF810O 

*****C1 ****•*•**• 

• S7.T0P pef * 

*BODUXE P.SL, TIE* 
**OD0LS OBFtMIHt;* 

• SEQ ELHT. * 



.*. 

A2 *. 

.* AWT *. 

, *(TNR?SD1.9EP *. 
.HOPfJLP FXTRA 1 ?. 
*. TORINO . * 



***« 



A2 ' 

r*** 



********* 




• ««• 




* * 




* D1 *-> 




* • 




**•* 




1PB200 




*****D1 ********** 


• * 


• SCII FOB 5PQ * 


•■ITB BO* 


IkL BABB* 



*****:************ 



IPB520 



f1 



► BQOIL *. TBS 
VAVB POMD .* 



*****P2* ********* 

* ADD TO 08 ?ORK * 

*cn»Tir of rpoxr ♦ 

* <TSB OLD SRQ • 

* BTTBF- * * 



• 13ST61 IB* • 

•BTTRB • TO 3IQ ■ 

* nilT. * 



»F1"220 



AFB600 



KSL SX.HI. 



•♦***********♦*♦* 



TBS .* APT 
r — ♦. BOFE SSI 



• Dl • * I 

• * Jl *->1 
***** * I 

• *** 7 



TEXT *. TBS 
RCD fBXr .* 



* TRTTLZ TO • 

* RMDLR TEXT, * 
-->*5FTaP BDTLD H^H* 

* TEX* BCD IBP* • 

* • 
***************** 



*****B2********** 

* PIACB BIDS IB * 

* S09TB0 ORDBB * 

* THBBDrHTBlT * 
•BEBIBD TBJCT TH * 

* PCD. * 



IFB800 

*****j2*********« 
*RFPt OBTrt EXTHB* 

• •S IH TF-XT SITS* 

• FEB EXTRH fS • 

• CORR1RF0SMBR ♦ 

• TO SBO F.L8TS * 
*******«•******•• 



L 



AFA2ift 

•****>3** 
*TH T T17. ro SCAN 
•FDR DHBEsOtTFP 

■-->• EXT°K5 TO 

* HODOl,* TB 

• LTBBABY 



* 65 • 

* * 
• *** 

AFA'OO 

***** P3 ********* 

* SCAN "OF 

* GBFFS3T.V*D 
•BXTRH n-0 FODffLF 

* TH SBO IT*T 



C3 *. 
• * 

GOOP * 

EXTBB RF0 

FOtlWO . * 
*. . • 



fl? 



• SF.T fiBFESOrVFD 

* nonni.p »tthh 

->*FOITND 30. SCAN 
•DA^T OV DIB T(T 
•COBB FOF HAT* 



.* ANY 


?FD *. T*S 




.* NATPR * 


*. «ITf .* ■ *- POOHD 


*. BO-MBD .* 


*. . • 


*. .* 


• . . • 


*. . • 


*. .* 


* HO 


* RO 






i **« 






* 






l->* m 




r 




*** 


.*. 




.*. 


F3 *. 




Fd •. 


. * *. 




.* *. 


1*3 .* AWT *. 


1 .* AST • 

I— >♦. *3P» DTP OP 


r — *. FOOBD .* 


*. BODOLPS .* 


*. i.tb .* 


1 ♦. .* 


* ■ . * 


7 ♦. .* 


*. .* 


**** « *TBS 


* no 


* * 

* B«i • 




i 




* * 




**** 




* * 


• IWTTLZ TO SC1W • 

• SEQ LTST FOB • 

• FOflBD nOD1l»«I * 


* * 




***♦ 




* * 




* S3 *-> 




* * 




«*** 




A'soon 


1 


*****Q1 ********** 

• * 

• scab fob BOtrnD * 


* BOniTLE * 


• * 


* * 







«**• 
> I 

■ ni i 

• i 

**** 



*****PS *»*•****«« 

*sbtftp nrsF i or • 

■>* T»»0 THTO SFQ * 



**** 

* • 

».->* B3 * 

* * 
**** 

*****y^**« ******* 

* BPDATF • 

* DTJfBCTORT TH * 
->* BPP AITO 1550C * 

•PARAK. HWSTART * 

* PFO SCm * 



l->* B3 < 

* t 

• *** 



H3 *. 

.* SEQ *. 

.•BLBT flODD!.**. 

'. TO BB 

*.RESOHTPn .* 



TP5 



**** 

->• A2 * 
• * 

*•** 



* FTT.L HOOnLF • 

* BffAO BFB R • 
** IHIfTz TO • 

* HlMDtE * 

* * 
»*********•••**** 

I**** 
* ♦ 

->* r^ * 

* ♦ 

AB/01/A1 

****,^i) ********* 

* * 
•*TTT TO SOLFSG *<■ 

* * 
********v****** 



*•*• 

* • 

• * 
•**• 



**** R s********* 



conpR^ss 

AUTO-LIF^ TTST 



>* J1 • 



*. .* 
* BO 
I 



.« BHD BCD *. HO 
BF-XT .*— 



»2 •. 

.♦ 
.* S RCD 
— ->*. fr'F-XT 

*, 



****^3********* 

* BBB HALF > 

->» oitHrcosjjrr.FD < 

♦ 8ECOK0 < 
***••*•****•*** 



i < 
**** 



HH/0VA1 



* EtTT TH SOIAH • 



■>■ G3 * 

* * 
**** 



■>• CI ' 

* i 
**** 



• Chart AF. Auto-Link Segment List Build ($OLAF) 
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n****< 

F.FTFP 



**** 
THK120 



TM*UO0 



.* CAP1 

>•. T7P" 



• **• 
* 1 



■>*. SEgnFUCF 3F 



PTBST *. TFS 

CARD 0' B . * 

DBCF . * 



**** 

* i 

* P3 < 

* 4 
***■ 



CFBC* 

snn o* 



*'o«' at t b. rvom 

•>**T\T>Ttl m»D to « 

* Lnnnoi ' 



• so 



* PFIBT C»*D DH 



**************** 



pot arcono ^o ■ 

JBORf 



**** 
* * 1 

: •" :-»| 
•*** ( 

TUMIO T 

***o^ ****** ****** 

« BBAfl curl ♦ 

— > FROH SYSTN 



IKK130 



P-2 



•****T3********* 



.* PP.ASP. *. TES .* PBYOB *. BO • 

■. OB OPTTOBS -■ >*. CABD LTFF .* >♦ FETCH I0LTB1 

*. , * a, T* , * * 



* *. TF.S 

TBCLCIDE .- 

*. 



..-- 1 



***■ 

* * 

* G7 * 

* • 

tt*» ■«■■ 

* * 

* F 3 « 

* i 
**** **** 

* G2 * 









* 33 * 

• * 
•**• 


**** 

| 




.*. 

PI •. 

.* GSODP *. 
.* CATFGOFT 
, . *.j FCOATB 3F 
*. EHO 
*. - * 


* 
* 


BO 

*«■* 

• a 

* F3 * 

a * 


!70 V 
ta«**G2 ********** 
■ • 
> * 
' FIBD BODDIF • 
r * 


< 


« TFS 






JHF180 


********* 


280 

•**P2a< 


1 
***** * 


**•• 



* RBAD 1 SBCTOH * 
PROM LIBRARY 



***************** 



****J1********* 
* 
♦ BUT TO F0LIB3 



n *. 

• *, 

SO . * (10RB *. 

— ■. I10DOLFS ,*<- 
*. BAHFD .* 



i** j2* *********** 



• PDT 5 HICOHDS * 
TB SWOHF 



EBD OF *. BO 
HODPLE ■• 



****p,H ********* 

* • 
■>*FXT* TO I0LIP1 • 

* * 
*************** 



*****V3**1 

**OLF,B 



AT/0 1/A1 



CSSDF FAIT 



***************** 



CnHFFBT 



****?*, ********* 



• •** 

* * 

* 81* 

* • 
**** 



P*TBT CO-.-.EFT 

oir STstOG 



• G3 *—■ • 
\*./ I 

ikf2«>0 * 

**»**G3********* 

* 

• SCAB FO0TTBF 



T 




.*. 




P3 *. 




. • *. 


• ** 


.* STHTH *. SO 


* 


*. OF .* 


->* FT 


*. . * 




*. .* 


*** 


•. . * 




► TTS 




• *** 






* * 






• 33 *-> 






* * 






*a*« 






TFK2^ 


1 




*****$3 ********** 




* * 




♦GET BODfftF FANE* 




* FROH SCAB ■ 




* OTJTfftTT * 




* * 





*****F3***i 



• POIHT TO HFXT * 

* HOIMJIF III** * 



**** 


* YFS 


* 


i **** 


r-5 * 


* • 


* 


l->* J 3 • 


• *** 


* * 




«aa« 



***• 

a t 

• G2 * 

• * 
**** 



• Chart AG. User Entry Phase 3 ($0LIN2) 
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***»*B2**+******* 

• • 

• INITIJIITZF - • 

• SET JSOOBCE • 

• BtJPTER 3I2B ♦ 



*****C2********** 

* • 

* DO TEITIM • 

* SEGUE** LIST • 

* 1DJID • 

* * 
***************** 



&HH0OO 



boiid 1 xibp 

sigh but list 

elbubIt 




SET BOPSDHHT 

•ftLTGH, TLLMiL * 

•C»LL I«DTC»TOfiS* 



, • XRjer 

ITST 

•.COMPLETE . 

*. .* 

*. .♦ 

• TBS 



IRIOOO T 

•****p3********** 
•SET PIBST LEVEL* 
*■ 10 DEPESOENCT * 

UISTtIoH GEO?* ♦ 
• SCTTS * 



***** C 3******** ** 

• PBOPAGATE TO * 

• DEPEBDEITCT8CIIL* 
*DP USBB BO0*IEE* 

• - THE? LtST * 

• • 
***************** 



»ma dupltcite • 

* flQDtllE 11D * 

* E1TBY POTBT * 
♦BBBOBS TV IREP * 

* ITST * 

***************** 



••••*£3********** 
*POIBT TO EQOAL • 

• JEEP EtEHElT IE* 

• M1T0ITEK * 

* 3BGHBBT LIST * 

* * 
***************** 



HE-POO Q 

*****P3********** 

• BDVE OIIGIIIL 
•CkTBGOBtBS FfioB* 

• PBB-1ET0ITEE 

• LIST TO XBEP 

: mi***,* 



IHC1BG 

**t**£3****** 

DO FTBU 

ffifttEt LI' 

tRUE 



SBGttBM LIST 



H/01/11 
****p.3********* 
* BJTIT TO EOLXJ * 



i Chart AH. Cross-Reference Segment List Build {$OLAH) 
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!£>£>0 



k*«««3l*«««««**»« 



• GET HHLT ?BOH • 

• E880» TABLE • 



EB025 

* BOILD • 

* K»LT/S3fSLOG • 

* PIRfl SIYIHG * 

* HALTS AND • 

* OPTIONS • 



D1 

.• 

• • LOG 

#, 


•. TBS 
01 .♦ 




» 


KO 


* * 


SEE WDTE 1 

* • 


• •HALT/STSLOfi* ■ 

• • ISSBE 3 • * 

• "LEVEL HALT • • 

• * * • 



SEE VOTE 1 

• * • 

* *HALT/STSLOG* 
■>• • ISSUE 1 • 

• *LEYBL HALT • 

* * • 



EiOBO t 



PASS OPTTOW 

TAKEI BACK TO 

CALLER 



* BETOBIt TO < 

• CALLER « 



SEE IBS StSTEfl/3 
DISK SISTERS SYSTEfl 

C0HTBQ1 PBOGBAH 
LOGIC .1AH0AL 
ST21-0502 
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i 

BBTFP * 



<B' 
) 1 
70B 



LIST 
lOQT 
5 P «... 
• IMTO 50BT-SEQ- 
LTST 



•*CA»J_SEO. 



HJJtlOO 

*****C1 ********** 



GET COflWDH 
ELEMSHTS 



AJA2O0 

«*«**m *•+.****■*' 



s»t np bdot 

nUTWtTHE 



***************** 



AJfcfiOO 



70RH BOOT 
KEBKAL 



i*********»**i 



SSA310 b * 

* ATTACH »U. 

* PRI08TTT 

* SLEHRWTS TO 

* BOOT 



* HDD ELEBESTS * 

♦ USED BT * 

• PRIOHTTV » 
J TLEHERTS to • 

* BOOT » 



AJAMO 



* BTJTID SOCU • 
•CATEGORY f 1-71 • 

* OVERLAYS * 

* * 
***************** 



IJT00O 

*****j1 ******»**:* 

* * 

• ADT> MD LIRK * 
•TBASSPEH VBCTOfi* 
■ ELEHEWT * 



*BUTLD 1ST LEV*L* 

* LOCAL 07FPL1T • 

* STBUCT'JBPS * 

* • 
***************** 



• * 
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*B1TLB 2HD L?V1 • 

• LOCAL OVERLAY * 

* sTBucmsrs • 

***************** 



*****C2* ********* 

* 1UIT.D OVPRLA* • 

* STRUCTflftE V0« • 
•ABY HCDDLE KOT * 

* TFT APT)?B • 



AJCim 



*CHATN 1HJLTPL? • 

* APPEAEASCR * 

* nODHLFS • 



AJC110 Y 

*****P2********* 

• TKCtnnE boot 

♦CALLED MODULI'S 

* th ROOT OH 
■ OYEFLAf 



AJCZO0 



AX/01/M 



* KTTT TO SOLA* * 



• Chart AJ. Sort Auto-Link Segment List ($OLAJ) 
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EOLAF 



APKOOO 



EUTER 



HPC500 



♦COHPOTB BOFFEB 
• SIZE 



****•**«***•( 



BITTER « 



•SET COB BON ROOT* 

* 1SD OVBBLAT • 

• area SUBS TO • 
♦MULTIPLE OP 256* 



SNTEB 



♦COKPOTB COflflOB 
• LENGTHS 



afcooo^ »;„JJ£S# A1 

•CAfl • 



LOAD SEGBBBT 
LIST 



• C2 »-> 

• # 
• *** 

APL120 

*•**»£ 2* *******«• 

• SELECT BEIT * 
*BODOLB IN OSDEH* 
•OF PRIORITY AND* 
♦SIZE FBOfl 50 RT • 



•**w «**•** •**•>■ 



APB100 



AK/01/A* 



APL28Q 



•APHOflO 



* SON 8SO0IR8D • 
♦COBB C OVEBLAY * 

• AREA SIZES * 



D2 «. 

► *. 

HODQLB ! 
FODBD .» 
». •• 

♦ , „• 
* (TO 









• **«*cit* 










• FIND COBE * 








•REOOIRBBERTS OF* 
• BE« OVERLAY ♦ 














• FBOGBAB * 








• * 








•*** 










* * 










• DU *-> 










• * 










**** 




♦ *. 






APB«0O 


D3 •. 






• •■•*[)^ ■■«««««««* 


• • * 






• * 


HO DOLE FIT 
• . IN ROOT 


*. VG 




• GET ELEBEBT • 


. * — 


— , 


♦ FROH SOBT LIST * 


* 


1 


• * 


*-. .• 




• • 



• YES 



El ♦- 

TES^."" PBOGRArt 



ASSIGJi ALL * 

non-zero * 

hodules to * 

overlays • 



AP13 



♦ C2 * 



RETURN 



* 

ADJUST BOOT. *■ 

"" TABLF ' 

SIZES 



FETCH TABLE, TV* 
~2r~ 



Eft 



ESD OF 

LIST 



■>» BETUBN i 



* • 

->• « • 

• «•* 
APKOOO 

• EHTEB * 



APH630 



APC060 V AK/01/A2 

•AFLOOO • 

• * 

► RE-INLCODE • 

* ELEMENTS in • 

• BOOT * 



HI 



-• ART *. YES 
••RE-INCLOSIOIf .• 



AK/Q1/P3 

•APKOOO * 

■XFRFE ALL SIBCLE* 

* CAHDTDATE • 

* OVERLAY ABEAS * 



APC090 

•AfNOOO 



iK/02^1 



♦ CONFINE OVER- • 

* LAYS* ASSIGN • 
» OVEKIAY 10S. • 



AK/01/F3 

"AF'OOO • 



APK020 

AFHOOfl 



.« TRANSFER 
VECTOR 
«. ELEHENT . 
♦ . ,* 

* YES 



» SOB OVEELAY • 
■>*CASDIDATE SIZE • 



*****G3*« 



V A 



AK/01/fcft 



->* Dtt * 



♦ COURT BO. OF • 

•CANDIDATES FEB • 

* OVERLAY ABBA • 



AFX0 80 

*v***B3 ********* 

* FREE AMY 

* OVERLAY ABEA 

* WITH OBLY OltF. 

* CANDIDATE 



• £A?E SIZE * 

• LARGEST • 

• CANDIDATE PER * 

• OVBHLAY A£EA • 



• COO ST NO. OF 
■-•CAHDrOATES PER 

* UVE LAY A!lEA 



D4 * 
• *♦ 



YES 



**tEE ALL SINGLE*- 

CANTTOATB * 

1 "VFRIAY ARSAF » 



" CALL PHASE ' 
' SOLAA ' 



APK300 .». 

J3 *. 

.• ANY < 

• OVERLAY 
AREA 

•. FRBED 



■ « 

RRTOBB * 
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APffOOO 

* BSTER ' 



.*. ip a 100 

Bt *. ****#b2********** 

N *. • COHBIM * 

0»BSL1T *. IBS • OVERL1TS «ITH * 

IBBDSD .• — >• BQQAL BLEHBM * 

.* * POIITBfiS + 



APH010 

*****C1 ******♦♦•* 

* 5BT *LI * 

* B1EHESTS TO * 
BOOT I 



ZLIBIJUTE 
~ ItBS 



DBPLICltBS 



**»*P14*««*«*** 
> BBToaa « 



1PN40O 

**va*C2*** ******* 

* • 

* COHflXME • 
•0VB1HJ5 IBBBB • 

* POSSIBLE * 



iPEfiOO T AH/01/F3 

*****[}2***«****** 

**PK0Q0 * 

* — ,_,- * 

•BiEE ABE* BITH * 
•SISGLB 07EBL11 * 

» • 



B2 *- 

.*SB&LLB»*. 
,* PBOGB1B ' 

BItHOOT 
*.0TBBL1TS .< 



+ APK0 



33' 



•>* FBBE ALL 
* OVEBL11T 1HEAS 



1PI610 



•ASSTGB OVEBL1I * 

* BOHBEBS *- 

* « 



* « 

■>* SETOBM * 



Chart AK (Part 2 of 2 ). Overlay Design ($OLAP) 
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ATG10 

* * 

* ESTES » 

*♦****•*******♦ 



*m*m*B2********** 

* * 

* FOBMAT OUTPUT * 

* DEPENDING ON * 

* HAP OPTIONS * 



AT030 



* PBINT HEADIHG 

♦ LINES 



•**D2* *********** 
INITIAL BEAD 
• OF THE * 
OVERLAY AND 
• XBEF SEGBEKT * 
LIST 
***************** 



ATC1QO 

**m**El ********** 



BDILD PRINT * 

LIKE AHO PRINT *<— 

THE LIMB * 



AT100 


.*. 

E2 «. 






CONNOR . 


* ■* 




NODDLE**** 


.* 


SCAN 


», 


NAME * 


.r*. 


OTEfiLAY 




*— >♦ A4 


• , 


LIST 


.♦ 


* 



•**P2** ********** 



PBIHT COBE 
SIZE MESSAGES 



ATK100 ? 

**m**xH ********** 

* BUILD PBIHT * 

* LINE 7BOH • 
*OVE£LA? SEGMENT* 

* LIST BHTBY * 



m mm nn**** ******* 
USING PTB IK 

' OYEflLAY LIST < 
GET XBEF LIST 
ESTBY * 



Id PfilNT • 
RITH NAME 



• FILI 
*LINE 

• S KEFE&ENCES 

• • 
mm*************** 



'BOB XBEF * 



•HOVE PTR TO OBJ* 
♦CODE PHOH xgr - 
• TO OVEBLAY 



******* *******m*m 



PfilNT LIME Off * 
P8IHTBH 



SCAN 
XBEF LIST 



*****£ 2* ********* 

* CHECK FOB * 

* BfiBORS AND * 

* PHIIfT EBBOB * 

* MESSAGES * 

* * 
***************** 



AT270 



H2 *■ 
EEBOR 



AI/01/A1 

m***.mR3*****m*m** 

♦saLpa » 

■>* ISSDE B8BOR * 

* HALT * 

• * 
***************** 



BNTEI 
POINT 



*»***GQ ********** 
*BOILD LINE WITH* 

* ESTHY POI8TS, • 

* ADDB AND * 

* EEPEKE8CE * 

* * 
***************** 



v**[f(| ****** ****** 



PRIKT LINE OH 
PHINTEfl 



***************** 



AT290 



•***j 2* •**••*•* 

* CALL PHASE * 

* SQL BE * 

* » 
*************** 
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START 

•***A2********* 

* t 

• ENTER « 



INTT 

•»***B2*** ••***** 

•INITIALIZE AND • 
•CONFUTE STEF OF* 
• BOPPBBS • 



* B3 

• ••• 
*****B3* *••••*•• 



' 1 



ENTRY 



• *** 

k • 

» B J * , 

" * 1 

• *•• 7 

.*, 



BXT8N 
TYPE fiLD 



*** C 2*** 



******* 



*•*• 

' Dl « 
> < 

**** 



****Dl ********** 

■ 

POINT JIT NEXT • 

RID IN TEXT * 

ft ECO St) * 



• BEAD OVERLAY 

• SEGHENT LIST 



***************** 



***• 




• * 




* C3 ♦-> 




•*** 


BELOOP . *. 


C3 * T 


. • BUD OF * 


YES .* SEGHEHT 


*. LIST 


•- BDPFER 



>* BBLOCATI TEXT * 



• *** 
> 1 

* Dl « 
( < 
**•• 



SEARCH ESL 

TABLE TO 

BESDIVE EXTHH 



El *. 
* *, 

END OP 
BOTFER OH 
. HODRLR . 



P2 



NEW 

OVERLAY 



**»**22** ******** 

* RP-TNITI1LIM * 

* START OF ESI ■ 

* TABLB * 

* * 
A**************** 



FXTBIT 
RESOLVED 



• **» 



« TEXT 
OOT OP 3 EC 



*••• 
i * 

' E« * 
i • 

*•** 

THDPTR 



BBTTPF .♦. 

ESL F2 •. 

TYPE -•SECHENT* 

.* LIST 
r — ■•. ELEMENT 
*. TYPE 



' B3 • 
*•*• 
NODDLE 



PBDTLO 
BED OP *****FJ********** 
SEGBENT * READ OVERLAY * 
*. LIST * FETCH T1BLE • 

.* >* PORTION OP * 

• * OBJECT CODE • 

* * 

***************** 



• HOVE TEXT TO 
•OBJECT BDFFE2, 

• WRITE OBJECT 
•BOFFSK IP PULL 



• BOVE ELO TO RLD* 

• BOFFEF, (TRITE • 
•BUFFER IF POLL ♦ 



FIRST «, 
HOBBLE TH . 
, OVERLAY .• 



■****H2** ******** 

• SATE PELATTVE * 
•C/3 DP OVERLAY • 

• AND LEBGTH OP * 

• OVERLAY * 



•****G3 **•*■•***■ 

• • 

• POT WELITIVE • 
•C/S OF OVERLAYS* 
•IN FETCH TABLE • 



**•* Hi* ********* 



NRITE FETCH • 
TABLE * 



•*•••***•**•**** 



END OP 
BODULE 



HO 



KflSVAD 

*****j2* *••***•*• 



•BEAD BODDLB TO * 
■>* TEXT BOPPPft • 



AD/OVA 1 



• PRINT ADDRESS • 

■ OF NODULE AND • 

r->*OVEHLAY ERNBER • 

( • ON SYSLOG * 


****** 

• 






• 
**** 








SEE NOTE 


* 
* 


EXIT TO • 
HALT/SYSLOG • 


a************** 


HALT 18,20,23,28 



SEE IPN SYSTSN/3 
DISK STSTEBS SYST8B 
CONTROL PROGFAN 
LOGIC HANBAL 
5Y21-0FW2 



• FXIT TO JOLBO * 



\ **** 

* • 

t->* C3 * 



C3 

i 
• *•• 



*••* 

■ < 

* D1 « 

■ * 

*•** 
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CM10D1 

• ENTER 



♦ ♦ 

* • 
•INITIALIZE DTF • 



9 AN/01/G' 

•CA5«T • 

• „ _„ .«_■ — • 

• CALL WAIT • 

• SU&nOUTINF * 



• *•• 

* i 

* B2 * 

* t 

• ••• 



• •. 

D2 *. 
.* ALL *. 

.• S£CT0h5 •- NO 
». HITKIS .«--■ 

*. LTfUTS .* 



IS THIS 
A POT OP 



YES 



SET EOF 

COflFLETIOB 

X*H2« 



» MDICATE READ 



► >• 



IK LOB 



SET END OP 

E ICIEST 

COMPLETION 

X'70' 



DECHBHBNT * 

HDHBZR OF • 

SECTOBS * 

SEQUESTBD ST 1 • 



Dl «. 






-• -, *. 




.• 15 THTS 


• , 


SO 


. A OET Oft 




»___., 


*. PUT 01 J .* 


1 


•• • • 




It 


*. .* 




« HES 




• ••• 


• **♦ 1 




» 


♦ 




• F3 


El ♦-> 




* 


• 




**•* 



•INDICATE UNITE 
• IN IOB 



u>: 



>♦ F3 < 

t 
• *•• 



L 



>* El • 



CinOtt » SEE NOTE 2 



•DIODSP DISK 
* IOS 



CAN0 11 V AN/0 1/fi3 

•CASCVT • 



CAK035 .*. 

E3 



AH/OI/GM 



•CALC DISK * PORi 

• 1ST SCTrt • 

• ACCESSKD « 



13 WAIT 
SPECI«ED 



CALL WAIT 
SUBROUTIKE 



CAKE4U 

• SET MO 6ECOBD • 

*. YF.S • P0U8D * 

,♦ >• CUSt'LETTuS • 

• A * X'UU* • 



• •** 

• • 

• F3 •-> 



• **♦ 
CAK0<) 



» F2 ' 
i ■ 

• •* + 



L->* r3 • 



TOLi 
OF 



Nfh= MJJ13EK 

.SECTOBS 
rtlNUS 1 



KETUBS TO « 
• CALLEU < 



cAncrr 

• SNTEB < 



MUTE 2: 

5EE I8H SISTEH/3 

DISK SKSTEBS DATA 

RAHAGEHEUT AND INPUT/ 

OOTFQT SOPEHVISOtf 

LOGIC ailfUAL 

SY21-0512 



► I OF *. 

SECTORS = , 
l . . * 



CAPllHi! 
*•» 

•CA1CVI 



SET iUnHEo OF 

sacToas 

htyUESTliD TO 1 



L->« F2 < 



*****t]3«*«****** 



•CALCULATE DISK 
• ADDBESS 



CAHNT 

• i 

• ENTEa < 



V SEE NOTE 2 



V AN/01/G.1 



'COIFAHP FOB 
OP FILE 



* COflPABE DISK 
•ADDBESS TO t'UD 

• OF FILE 




'. PEa/IANEMT . 
•- EKttOH .• 



YES 



SET ABSOEWAL 

COKPLBTIOH 

X"t1» 



• *• • 

* • 

. U2 • 



• • 

• KETU8H TO NSI • 



• **• 



• itKTOaS TO NSI • 
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• • ♦ 


♦Al* 


>•****** 


• 




• 


F5JT5W 


• 




• ♦• 






• 


* 




* 81 


•-> 




• 


* 




• •» 


» 


THK120 


, * 




B1 *. 


, 


* • „ 


. ♦ 


*. 


■ 


r Dec* 


* 


. * 






.* 



****d ********** 



fftTST C*BD OH * 
STS105 • 



INK130 



.* PHASB 
•. OR OPTTOHS 



PRTOH *. NO 
CARD LIKE .*--■ 
XT . • 



• •** 
■ P1 *-> 



r9P0 V AT/01/ 
*****F 1 ********* 

•TOLPB 



• TSSUE HALT 



i ci *-> 



T8X110 * 
*•*&- 



* RPAP CAED 
--> FROfi SYSTN 



TNK180 

*****B2********* 



* FETCH PHASE 
>* *01IH2 



D2 *, 

> 4 

INCLUDE 



TNKIfO 

*****32********' 



* P^TCH PHASE 
-* fOLIHI 



AB/01/A1 



****P2********* 

* * 

•exit to soirm * 



.* COflilEMT *. 


NO 

N . 


*. .* 

■• .* 

*. . * 


1 


• TBS 


*** 

* 






• 81 

* 






i»t 




■ 




* PBTKT COftHENT 
ON SYSLOG 


• 
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AG/01/A1 
****B3*****a**« 
■>*EXIT TO SOLIS2 * 



* C6 * 



CS *, 



**** 
■ i 

' PI * 
• t 

• **■ 



D3 



TBK320 



. * *. YES .* SJHTAI 

■>*. CATEGORY .* >*. OK 



HO 



L- >* T1 + 



E3 *. 

i 

GBOffP 



. YES .< 

.*- >*. 



SIH.'AX 
Oif 



* PffT SBHAIHING * 
SEG. LtST TO 
SSOOBCE • 



*. 



NO 

**»* 

* * 
■>* F1 * 

* * 
**** 



. *. 

F3 *. 
" *, 

BO. CUTE 

i. . *" 

* * 
* YS5 



**** 
'.MO * * 

.* >* C5 * 



IHK600 

**»E5**** ******** 
PDT E PEC, 
* AHD BBHAIHIHG * 
MODULE TO 
* JHOBK * 



• SET DEFAOLT * 
♦OUTPOT trUIT IF ■ 
•NOHE SPECIFIED * 



SYMTAJt 
OK 



■. HO 

.» Tl 



IHK360 * 

*****G[i ********* 



• BOILD SEQUENT 
» LIST EFT BY 



INK657 $ 

***s*E 5* ••***+*+* 

* • 

* FltTD PBIHTBB * 
■ROOTIHE 6 SAVE • 

* CTL/SEC ADDB * 



IHK280 



t**H3********* 



BUILD SEGHEUT 
LIST ENTBY 



***• 

* + 

* PI * 

* * 
• *** 

THK710 



* POT SEG. LtST * 
> ENTRY TO 

* ISODHCE * 

***************** 

[ .-. 

L>* G1 • 

* * 
**** 



****H5***v ****** 



ALLOCATE 
PRISTEB 



********** ***** 



IHK659 



****K5********* 

* * 

* EXIT TO 50LAP • 
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SOLAR 

***»11 ********* 

* < 

* EITBB * 



*****B1**** •••*•• 

* • 
•GIT DITA 1BUS • 
« PBOH PBBVIOaS * 

* PHASE • 

* * 
***************** 



AP/01/A2 
*»***C1 ********** 
•AHH000 00112* 

* .-_• 

• BDILD OVBBLiY • 

* SECHEST LISt • 



ABC510 ? AP/01/F2 
*****n1 ********** 

•ABPOOO * 

*.- * • 

•ASSIGB TO BACH • 

• H0DHLE IN • 

• OVEBLAT LIST * 



ABC200 



200 * AP/01/Ett 

****** i ********** 

•ABBOOO * 



•BOILD TEXT FOB * 
•FETCH BTB TV'S,* 
• FETCH TBL • 



HPC300 * AK/01/A1 
*****pi ********** 

•CAM • 

«-..-„_.-.. * 

• DO FIBAL • 

• SEGHEHT LIST • 

• »RITE • 



'♦•*Gl •••*•**** 

CALL PHASE * 

SOLAT < 



LBKOOC 

•***42*« ******* 

• 4 

• BBTBR « 



***• 
i * 

*'B2 *-> 



**•• 
IBH060 .•. 

B2 ♦ . 

.• ALL ♦- 

,«El»HBBTS OF*, 
*. SOBT LIST 
♦.PBOCBSSED.* 



ABH320 



HO 



* 



cz ** 
.* BOOT •. 

.* jasr *. 1 

•.COMPLETED AHD.*- 



GET BBJtT 
>• BLEBBBT FBOB 
SOBT LIST 



***************** 



***»*C3«* ******* 



• ADD FETCH 
■>• BOOTIBE E5TBT 






.•BELQBS *. 

••TO OVEBLAT *. 
■>*. BEIB6 

•.PBOCESSED.* 



•ADD TO OVEBLAT 
■>• LIST 



| ••** 

* * 

L->* B2 • 



L***» 
• * 

>* B2 * 



ABH390 .*. 

D2 * 

,• MOVE 

.*6?BBLATS 

■. ADD TC 

*. LIST 

*. 



TO*. ICES 



*****D3********** 

•SET FOIBTEB TO • 

■>* FIB ST ELEBEVT * 

• OF SOBT LIST * 



I /•*•, 

L->* B2 « 

* i 

• *** 



****32********* 
» * 

* BBTOBH « 

*************** 



iRpoaa 



A6P0?P 

*****Q2 ********** 

• ASSIGB • 

• ADDRESSES FOB * 

• KODOLES IN • 

• OVEBLAT LIST • 

• * 
***************** 



ARP1MO 

*****H 2* ******** 

• ASSIOH 

• ADDBESSES FOB 

• EXTOUS IM 

• OY5BL4Y LIST 



*»»»J2********* 
BHTUHB " 
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1BB000 

****Bi|********* 

• * 

• BNTBB « 



ABB010 



BUILD OBJECT 

TEXT FOB FETCH 

HOCTIME 

*************** 



• BUILD OBJECT 
•TEXT FCB FETCH 

• TEBLE 



ASB050 



BOILD OBJECT 

TEXT FOit 

TBANSFER 

VBCTOBS 

*************** 



ARB1<40 



• ASSIGN ADD IB • 

• OVERLAY LIST * 
•FOB EXTRAS THAT* 

• flEilOIBE TV'5. * 

• • 
********•••**»*♦• 
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*0LHSG 



i i 

*************** 



*■***£ 1 ********* * 
ft « 

• <*** HALT FFO* " 

• WORF ABF* TU « 

• ionnon < 





***C1*« 








• 




■ 




* 


PBTHT BBROB 
*F.SSARP 


• 




• 


• 




• 




* 




• 




* 


• **• 










• P2 * 










* • 










• *•* 
1 




, 










.*. 




1 AT/OVM 




D1 *. 




? 




.• HER •- 




****D2««******* 






. TBS 


* • 


*! 


. * 


— >• fxit to sar.FB * 




*. TFF* . • 




* • 




*. - * 








*. . ■ 








i 


t HO 
AH/01 


/A1 

* 




** 


CALL PHASF 




• 


SOLAR 


• 




* 




B 





• * 

* 02 * 

a ■ 
*■•* 



• Chart AR. Error Message Print Phase ($OLMSG) 



Overlay Linkage Editor - Program Organization 30.1 



Page of SY21 -0530-1 
Revised March 15,1973 
ByTNL: SN 21 -7668 



Supervisor 



LOMMON 
Common Area 



Compiler Access 
Method 



$OLYNX 



$OLER 



$OLYNX Load Module 




-/ 



$OLER 



*^r 



SOL FTP 



$OLER 



_L 



$OLAF 

$OLAH 
$OLAJ 
$OLAP 
SOL AT 
SOL BE 
SOLMSG 



| 256 bytes 



SOLAR 



Figure 6. Compiler Entry Storage Map 
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Supervisor 



LOMMON 
Common Area 



Compiler 
Access Method 



Buffers 



I/O Area 



Work Area 



$OLINK 



$OLINK Load Module 




J 



$OLIN1 
$OLIN2 
$OLIN3 



- $OLAF ~ 
$OLAH 
$OLAJ 
$OLAP 
$OLAT 
$OL5E 
$OLMSG 



$OLAR 



$OLBO 



$OLFTP 



$OLER 



$OLER 



Figure 7. User Entry Storage Map 
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SECTION 3. DATA AREAS 



This section describes the data areas that pass information 
between routines of the Overlay Linkage Editor. 



OVERLAY LINKAGE EDITOR COMMON 
(LOMMON) 

The Overlay Linkage Editor common area (Figure 8) passes 
control information between the various routines. All of 
LOMMON, except for DTFs and lOBs, is initially set to 
zero by $OLlNK or $OLYNX. 



SEGMENT LIST ENTRIES 

The various routines of the Overlay Linkage Edition build 
a series of segment lists. These segment lists are built in 
the $SOURCE work file (Figure 9). Each entry is 16 bytes 
long. The format of entries varies between and within 
segment lists depending on the type of entry. See Figures 
10 through 14. Because all data fields in the segment list 
entries are not used for all types of entries, the column 
headed 'Applies to Segment Type' indicates which types 
of segment list entry will contain the data. Figure 1 1 lists 
all the segment types. 
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Routines 




Displacement 




Length 


that Change 




Hex Decimal 


Label 


in Bytes 


Data ($OLxxx) 


Description 





LODTFW 


52 


All 


DTFfor$WORK {see note) 


34 52 


LOiOBW 


23 


All 


IOBfor$WORK 


4B 75 


LODTFS 


52 


All 


DTFfor$SOURCE (see note) 


7F 127 


LOIOBS 


23 


All 


IOBfor$SOURCE 


96 150 


LORTYP 


1 


YNX, BO 


R module information 

Value Description 

XW Punch R module 

X'40' R module to R1 

X'20 1 R module to R2 

X'10' R module to F1 

X'08' R module to F2 

X'04' Replace as a permanent entry 

X'02' Permanent entry 

X'OT R to program pack 

XW NoR module 


97 151 


LOOTYP 


1 


INK, YNX, INI, 
IN3,AT 


module information 

Value Description 

XW Punch module 
X'40' module to R1 
X'20' module to R2 
X'10' module to Fl 
XW module to F2 
X'04' No core map 










X'Q2' No cross-reference entry 
X'OV module to program pack 
XW NoO module 


98 152 


LOSWT1 


1 


INK, YNX, AF, 

IN1JN2, IN3 


Overlay Link Switch 1 

Value Description 

XW Segment list in $SOURCE 

X'40' User call 

X'20' User specified overlays 

X'1 0' Start control addr set 

X'08' Groups in segment list 

X'04' Reserved 

X'02' Print messages 

X'01 ' Override 6E halt, Retain-R 










specified 



Figure 8 (Part 1 of 3). Common Area (LOMMON) 
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Routines 




Displacement 




Length 


that Change 




Hex 


Decimal 


Label 


in Bytes 


Data ($OLxxx) 


Description 


99 


153 


LOSWT2 


1 


AF,AH,AJ,AR, 
AT r IN1,YNX 


Overlay Link Error Switch 

Value Description 

X'80' System Cat called by User 

X'40' Not used 

X'20' An element in group 

is category through 7 
X'10' Not used 
X'08' Entry point not in program 

with common 
X'04' No find on start control entry 

label 
X'02' Core size in OPTIONS record 

or program will not fit 












X'OV Terminal error 


9A 


154 


LOUSPK 


1 


INK,YNX, IN1 


User pack Q byte 


9B 


155 


LONOVL 


1 


AP 


Number of overlays 


9C 


156 


LOPRPK 


1 


INK, YNX 


Program pack Q byte 


90 


157 


LOEND@ 


2 


INK, YNX 


Addr of partition end 


9F 


159 


LOCRSZ 


2 


AP, YNX, BO 


Actual exec core size 


A1 


161 


LORSV1 


2 




Reserved 


A3 


163 


LOFTBL 


2 


AR 


Displacement of OLFT 


A5 


165 


LOAUTO 


2 


IN3 


Relative entry number of auto 
segment list 


A7 


167 


LOXREF 


2 


AF, BE 


Relative entry number of X-ref 
segment 1 ist 


A9 


169 


LOSORT 


2 


AH, BE 


Relative entry number of sort 
segment list 


AB 


171 


LOPRDA 


2 


INK, YNX 


Directory addr on prog pack 


AB 


171 


LOOVER 


2 


AJ, AP, BE 


Relative entry number of 
overlay segment list 


AD 


173 


LOUSDA 


2 


INK, YNX, INI 


Directory addr on user pack 


AD 


173 


LOLIMT 


2 


AR,BE 


Relative entry number of last 
delimiter 


AF 


175 


LOWKCS 


2 


1N3, IN2, INK 
YNX, AF,AR 


Relative sector number of next 
sector in$WORK 


B1 


177 


LOLQBT 


1 


INK, YNX, BE 


Q-byte of data pack 


B2 


178 


LOLCSB 


3 


INK, YNX, BE 


C/S addr of data start 


B5 


181 


LOLHDR 


1 


INK, YNX, BO 


Library type R or O 


B6 


182 


LOLNAM 


6 


IN1.YNX, IN2, 
FTP, BO 


Module name 


BC 


188 


LOLLCS 


2 


BO 


C/S of library entry 


BE 


190 


LOLCAT 


1 


YNX 


Overlay category of R 


BE 


190 


LOLTXS 


1 


BE, BO 


Number of text records in O 


BF 


191 


LOLLEA 


2 


INK, YNX, AR, INI 


Link edit address 


CI 


193 


LOLRLD 


1 


BE 


RLD displacement 


C2 


194 


LOLSCA 


2 


YNX, IN2, AJ, AR 


Start control address 


C4 


196 


LOLCSZ 


1 


INK, YNX, IN1,BO 


Execution core size in 1/4K incr 



Figure 8 (Part 2 of 3). Common Area {LOMMON) 
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Routines 




Displacement 




Length 


that Change 




Hex 


Decimal 


Label 


in Bytes 


Data ($OLxxx) 


Description 


C5 


197 


LOATB1 


2 


IN1JN2, AF, BE, 
BO, YNX, AJ 


Attributes 

Vaiue Description 
X'8000' Permanent entry 
X'4000' Inquiry 
X'2000' Inquiry invoking 
X'1000' Must run dedicated 
X'0800' Requires source 
X'0400' Deferred mounting allowed 
X'0200' Reserved, must be OFF 
X'0100' Reserved, must be OFF 
X'0080' System input dedication 
X'0040' Checkpoint restart program 
X'0020' Direct source read 
X'0010' Reserved 
X'0008' Reserved 
X'0004' Common 
X'0002' Reserved 
X'OOOV Reserved 


C7 


199 


LOLLVL 


1 


IN1,INK,YNX 


Release level 


C8 


200 


LOLTSC 


2 


YNX, BE 


Total sector count 


CA 


202 


LOUVORK 


31 


Any 


Phase work area 


E9 


233 


LOCZER 


2 


INK, YNX 


Constant of zero 


EB 


235 


LOCONE 


1 


INK, YNX 


Constant of one 


EC 


236 


LOCHFF 


2 


INK, YNX 


Constant X'FFFF' 


EC 


236 


LOCM1 


2 


INK, YNX 


Constant of minus one 


EE 


238 


LOSCAT 


1 


AH 


System category 


EF 


239 


LOPTCS 


2 


YNX, IN3 


C/S addr of printer routine 


F1 


241 


LOERCD 


1 


AT, AF 


Error code 


F2 


242 


LOENTR 


6 


INK, IN1,AH,YNX 


Entry point name save area 


Note: 


Unused por 
These areas 


tionsof the DT 
are: 


Fs are used to st 


ore load lists of the linkage 


editor modules. 










Routines 




Displacement 




Length 


that Change 




Hex 


Decimal 


Label 


in Bytes 


Data ($OLxxx) 


Description 


02 


02 


LOAJ 


6 


AF 


Load list$OLAJ 


23 


35 


LOAP 


6 


AF 


Load list $0 LAP 


29 


41 


LOAR 


6 


AF 


Load list SOLAR 


40 


64 


LOAT 


6 


AF 


Load iistSOLAT 


6E 


110 


LOBE 


6 


AF 


Load list$OLBE 


74 


116 


LOBO 


6 


AF 


Load 1 ist $0 LBO 

Load List Format 

2-byte. Cy I/Sec Addr 
1-byte No. of Sectors 
1-byte RLD Displacement 
2-byte Start Control 












Address 



Figure 8 (Part 3 of 3). Common Area [LOMMON] 
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SSOURCE 


Segir 
00 


tent List Entry Types 


Pre- Auto 


Module name 


Segment 


01 


Entry point 


List 


02 


EXTRN 




03 


Weak EXTRN 


Auto-link 


04 


Global common 


Segment 


05 


Local common 


List 


0B 


EQUATE entry 




OC 


Transfer vector 


Cross- Reference 


OD 


Reference a previous name 


Segment 




or entry point 


List 


OE 


GROUP entry 




OF 


CATEGORY entry 


Sort 


FE 


Nulled entry 


Segment 


FF 


End of segment list 


List 






Overlay 






Segment 






List 







Figure 9. Segment Lists in $SOURCE 



Bytets) 



Bitts) 






0-3 





4-7 


1 




1 




2 




2-5 




3 


7 


6-7 





6-7 

8-9 
A-F 
A-B 
C-D 

E-F 



Routine that 

Sets Data ($OLxxx) 

IN3 

IN3 
IN3 
IN3 
AH 
IN3 
IN3 
AF 



AJ 

AF 
IN3 
AF 

AJ 

AF 



Applies 1 


to 




Segment Type 


Description 


OE, OF 




Reserved 


OE, OF, 


OB 


Segment type (see Figure 9| 


OE 




Group number 


OE 




Category override number 


OE 




Work area-original category 


0E,0F 




Reserved 


OE 




User area specified for module 


OE.OF 




Reference number— pointer to 
module element in Auto-Link 
Segment List* 


OE 




Reference number— pointer to 
lead element in last overlay* 


0E,0F 




ESL Sequence Number 


0E,0F, 


OB 


Module name 


OE 




Reserved 


OE 
OE 




Module element pointer 
{moved from bytes 6 through 7) 
Reserved 



* Segment displacement within $SOURCE. 
Figure 10. Pre-Auto Segment List 
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Byte(s) 



Bit(s) 



Routine that 

Sets Data ($OLxxx) 



Applies to 
Segment Type 



Description 


















1 





1 





2 





2 





3 





3 





3 





4-7 


1 




2-3 




2-3 




2 




3 





3 


1 


3 


2 


3 


3 


3 


3 


4-5 




6-7 




8-9 




A-F 





A-B 

C-0 
E-F 



AF 
AF 
AF 
AF 

AF 

AJ 

AF 

AF 

AJ 

AF 

AF. AH 

AF 

AF 

AH 

AH 

AH 

AH 

AJ 

AJ 

AF 

AF 

AF 

AF, INK 

AH 

AJ 
AH 



00 

01,02,03,04,05 

02,03 

00,01 

00,01,02,03 

00 

00 

02, 04, 05 

00 

All 

00,01,02,03 

00 

01 

00 

00 

00 

00 

00 

00 

00 

00,01,02,03,04 

00,01,02,03,04, 

05 

00,01,02,03,04, 

05 

00 

00 
00 



COBOL entry 

Entry point or references an entry point 

Resolved to module and/or entry 

This module or entry point has an 

EXTRN referencing it 

Work area must be OFF at phase end 

Used— do not place in tree 

Calls a user routine or requires a transfer vector 

Delete this element when compressing list. 

Module already placed in root 

Segment type (see Figure 9) 

Category 

$WORK address of object code 

Entry displacement from start of module 

Number of entry points 

Module requires boundary alignment 

Module calls a user routine 

Module has I/O dependency 

Module already in an overlay 

Substructure pointer already built 

Object code length 

Reference number— pointer to equal 

ESL number in Auto-Link Segment List 

ESL number 

ESL name 

Reference number— pointer to equal 
O type in X-ref segment list 
Work area 
Reserved 



The Pre-Auto Segment List is included in this list and will appear 
as the first elements in the list. 

Figure 11. Auto-Link Segment List 
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Bvte(s) 






1 
2-3 



Btt(s) 


1 
2 
3 
4-7 



Routine that 

sets data ($OLxxx) 

AH 
AH 
AH 
AH 
AH 
AH 
AH 

AH 

AH 

AH 



5 


1 


AH 


5 


2 


AH 


5 


3 


AH 


5 


4 


AH 


5 


5 


AH 


5 


5 


AH 


5 


6 


AH 


5 


7 


AH 


6-7 




AH 


8-9 




AH 


A-F 




AH 



Applies to 
Segment Type 


Description 


00, 01 r 0D 


Reserved 


00,01 


Reserved 


00,01,0D 


Reserved 


00,01,00 


Reserved 


00,01,00 


Segment type (see Figure 9) 


00,01, 0D 


Category 


00,01 


Entry point displacement from 




start of module 


00 


Work area = number of entry 




points on original category 


00 


Module requires boundary 




alignment 


0D 


Categories make this call a 




potential program failure 


00 


Module calls a user routine 


00 


Module has I/O dependency 


00 


Work area - OFF at end of phase 


00 


Work area - OFF at end of phase 


00 


No reference made to this module 


01 


Same name as module name 


00,01 


Duplicate name 


00,01 


Start control label 


00 


Location of object text in 




$WORK(X'FFFF'=null text) 


00,01, OD 


ESL number 


00,01 ,0D 


Module or entry point name 



Figure 12. Cross-Referertce Segment List 
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Byte(s) 


Bitls) 


Routine that 

Sets Data ($OLxxx) 


Applies to 
Segment Type 





0-3 


AP 


OC 





1 


AP 


OC 





0-3 


AJ 


00,02,04,05,QC 





4-7 


AJ 


00,02,04,05,0c 


1 




AJ 


00,02 


1 




AP 


00,OC 


2 




AJ 


00 


2 




AP 


OC 


3 





AJ 


00 


3 


1 


AJ 


00 


3 


2 


AJ 


00 


3 


3 


AP 


00 


3 


4-7 


AJ 


00 


3 




AJ 


OC 


4-5 




AJ 


00,04,05 


4-5 




AP 


OC 


6-7 




AJ 


00 


6-7 




AJ 


02 


8-9 




AJ 


00,02,04,05 


A-B 




AJ 


00 


A-B 




AP 


OC 


C-D 




AJ 


00 


CD 




AJ 


02 


C-D 




AJ 


OC 


E-F 




AJ 


02,04,05,0C 


E-F 




AP 


00 



Description 

Set of modules already summed 

Set of modules contains a boundry 

alignment module 

Reserved 

Segment type (see Figure 9) 

Category 

Overlay number 

Number of entry points this 

module 

Number of entry points this 

overlay 

Module requires boundary 

alignment 

Module calls a user routine 

Module has I/O dependency 

Work area 

Reserved 

Overlay area used by this set of 

modules at execution time 

Length of object area associated 

with this ESL 

Length of object area this 

overlay candidate 

Reference number - pointer to 

equal module 

Pointer to module 

ESL number 

Pointer to module name element 

in X-ref list 

Pointer to next set of modules in 

same overlay 

Chain to substructure referencing 

this module 

Chain to other substructure and 

module 

Chain to last previous transfer 

vector element 

Reserved 

Boundry alignment adjustment 

factor 



Figure 13. Sort Segment List 
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Byte(s) 


Bitls) 


Routine that 

Sets Data ($OLxxx) 


Applies to 
Segment Type 








AR 


02 





4-7 


AR 


00,02,04,05 


1 




AR 


00,02,04,05 


2-3 




AR 


00,02,04,05 


4-5 




AR 


00,04,05 


4-5 




AR 


02 



6-7 

6-7 
6-7 

8-9 

A-B 



B 
CD 

C-D 

E-F 



AR 

AT 

AR 

AR 
AR 



AR 
AR 

AR 

AR 



00 

00 
02 

00,02,04,05 
00 



02 
00 

02 

00,02,04,05 



Description 

Work area - resolve to transfer 

vector 

Segment type (see Figure 9) 

Overlay Number 

Object time address for this ESL 

Object time length for this ESL 

Corresponding module type ESL 

number 

Address of module's first 

transfer vector 

$WORK location of object text 

3-byte RLD object time addr for 

this ESL 

ESL number 

Pointer to equal 0-type in X-ref 

segment list. FFFF designates 

overlay fetch routine 

Relative entry point position 

Overlay size - first type of 

overlay only 

Pointer to type entry in sort 

list 

Reserved 



Figure 14. Overlay Segment List 
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SECTION 4. DIAGNOSTIC AIDS 



APAR SUBMISSION 

For APAR submission, the following information is 
necessary: 

• Disk dumps of $WORK and SSOURCE 

• Core dump 

• Library directory dump of all routines used by the 
object program 

OVERLAY FETCH ROUTINE 

The Overlay Fetch routine is added to the root segment of 
every program that has overlays. It is built by routine 
$OLAR. When an overlay segment is needed during pro- 
gram execution, the Overlay Fetch routine is called. It 
fetches overlay segments from access devices and places 
them in the overlay regions in main storage. Bits are set 
in the overlay fetch table (Figure 15) telling which overlay 
region is used. 

The Overlay Fetch routine requires three parameters as 
input: 

1. Overlay number (one byte) 

2. Entry address of the overlay (two bytes) 

3. Return address from the overlay (two bytes) 

A transfer vector is built for each overlay in an object pro- 
gram. Transfer vectors provide input parameters for the 
Overlay Fetch routine. Overlay Linkage Editor routine 
SOLAR builds transfer vectors. Figure 16 shows the for- 
mat of transfer vectors. 



Relative 

C/S@ 


Number of 

Sectors 

TEXT 


Core 
Load 
Address 


RLD 


Flag 



Bytes Contents 

0-1 - Relative cylinder/start address of the overlay 

segment. 

Thfs is the number of cylinder /sectors past 
the C/S @ of the root segment of the overlay 
program as given in the object library 
directory entry for the program. 

2 — Number of sectors of text in the load 

module. (Does not include the number of 
related RLD sectors.) 

3-4 — Relative main storage start address of where 

the overlay segment is to be placed in main 
storage by the system loader. (Relative to 
the end of the Supervisor address.) 

5 - RLD start displacement. 

6 — Flag byte — used at execution time by the 

root segments Overlay Fetch routine. 

X'80' Overlay in core 
X'40' Non-I/O calling area 
X'20' System area 
X'10' I/O calling area 
X'OF' reserved 



Figure 15. Overlay Fetch Table Entry Format 
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ST 


OVFRS1,ARR 


Save the return address 


B 


OVFR 


CaJI the Overlay Fetch routine 


DC 


XL1 'IMN' 


One byte containing the overlay 
number 


OC 


AL2 (entry) 


Two-byte entry address 



Figure 16. Transfer Vector Format 



How to Find an Overlay 

When a process check occurs, the following steps can 
determine which overlays are in main storage and where 
to find them. 

1. Locate the address of the Overlay Fetch routine on 
the core usage map of the source listing (Figure 18). 



The Overlay Fetch routine checks to see if the requested 
overlay segment is already in main storage. If it is, the 
routine branches to the entry address of the overlay; if 
not, the overlay fetch table entries are checked to see if 
they use the same main storage. If they do, the overlay is 
flagged as not being in main storage. 

After the Overlay Fetch routine checks all entries in the 
overlay fetch table, it sets the 'overlay in core' bit in the 
overlay fetch table entry for the requested overlay. The 
Overlay Fetch routine then loads the overlay segment and 
branches to its entry address. Figure 17 describes the 
Overlay Fetch routine. 



5. 



Locate the overlay fetch table in the dump. The 
overlay fetch table is 1 15 bytes past the start address 
of the Overlay Fetch routine. It can be obtained by 
this hex formula: Address of Overlay Fetch routine 
+X'73 -overlay fetch table (Figure 19). 

Mark off every 7-byte entry in the overlay fetch 
table until the last entry is reached. The last entry 
is X'FF' (Figure 19). 

Number each entry left to right, starting with number 
1. Each entry refers to an overlay (Figure 18). 

Look at the seventh byte in each entry. This is the 
flag byte. The first bit will be on for every overlay 
in storage at the time of the dump (Figure 19). 



Overlay Fetch Table 



The overlay fetch table is built by routine SOLAR. It 
contains one 7-byte entry for each overlay in the program- 
Figure 1 5 shows the format of an overlay fetch table entry. 



Compare the numbers you gave the overlays in 
storage at the time of the dump with the number of 
the overlays in the core usage map (Figure 18). This 
gives the names and addresses of the segments within 
the overlays which were in storage at the time of the 
dump (Figure 19}. 



44 



•**** B 1 ********** 



•5A»E BEGISTBiS * 
•GET PARAHETERS * 



*****C1********** 

• SET POIBTEB TO * 

• CUREENT EHTBY • 

• IH OVERLAY • 

• FETCH TA8LE • 



.* OVERLAY 

*. iv anifr 

• . STORAGE 



***** 21 ********* 

* LOAD XH2 

* POINTER TO 

* START OP 

* 07ERLAT FETCH 

* TABLE 



****Q3********* 



RELOAD 
REGISTERS 



TO; OVERLAY 



**** 




• * 




• F1 •-> 




• * 




*•** 


' 


• •• 


Fl *. 


.* * 


.* OTERLAT 


*. USES 5ASE 


•. STO 


RAGE 



*****f2»*****»** 



YES 



SET OFF BIT 
OTEHLAY IK 

STORAGE 



*****G "!••••••••*• 



•5ET XR2 TO NEXT* 
• TABLE ERTKY • 



HI 



• LAST 

e5i 



*. YES 

(TRY .* 

*. CHECKED .* 



L 



*»** 

» • 

>* Fl * 

* • 

**•• 



****+H2** ******** 
•RELOAD POUTES • 

* TO CDBBBHT • 
>* EMM SET OB •■ 

* BIT IB CORE • 

* • 



•LOAD OTEBLftf BY 
->♦ BELATITE C/S 



****H5********* 
» i 

* EI IT * 



TO: OTEBLAT 



Figure 17. Overlay Fetch Routine 
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UVEAlAY LINKAGE tOITOR CURE USAGE *AJ> AND CROSS REFERENCE LIST 



START 


OVERLAY 


CATEGORY 


NAME ANO 




CODE LENGTH 


REFERENCED < 


ADDKfcSS 


NUMBER 


AAEA 


ENTRY 


HEXADECIMAL DECIMAL 


8Y 


- — 


i3oa 

2*FF 






127 


MAIN 




.lire 

0067 


103 


MAIN 


MAIN60 
MAIN50 HAIN60 
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Start address of Overlay 
Fetch routine 

Length of Overlay Fetch 
routine including Overlay 
Fetch table and transfer 
vectors 

Overlays in main storage 
at time of dump (Figure 19] 



OLIO* I TOTAL NUMBER OF LJ0RAAY SECTORS REgUlREO IS 4* 
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Figure 18. Core Usage Map and Cross-Re ference List 
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Figure 19 (Part 1 of 2). Sample 
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• ....♦.ft ....MAIN 
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Figure 19 (Part 2 of 2). Sample Core Dump 
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MESSAGES 

The Overlay Linkage Editor issues informational messages 
and error messages. Figure 20 lists these message numbers 
with the routines that issue them. For a full explanation of 
these messages, see IBM System/3 Overlay Linkage Editor 
Reference Manual, GC2 1 -756 1 . 



Message Number 


Issued by Routine 


OL016W 


$OLAT 


OL021 T 


$OLAF 


OL022T 


$OLAF 


OL025T 


$OLAT 


OL026T 


$OLAT 


OL027W 


$OLAT 


OL029W 


$OLAT 


OL031 W 


$OLAT 


OL032W 


$OLAF 


OL033W 


$OLAT 


OL034W 


$OLAF 


OL035T 


$OLAT 


OL036W 


$OLAT 


OL038T 


$OLAF 


OL042T 


$OLAT 


OL100I 


$OLAT 


OL101 I 


$OLAT 


OL102 I 


$OLAT 


OL103I 


$OLBO 


OL104I 


$OLBO 



Figure 20. Message Numbers with Issuing Routine 
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PART II 
CHECKPOINT/RESTART 



Checkpoint/ Restart 5t 
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SECTION 1. INTRODUCTION 



Check point/ Restart enables the user to restart a check- 
pointed program from the last checkpoint taken, provided 
no intervening program executions take place. 



MINIMUM MACHINE REQUIREMENTS 

• I BM 5410 Processing Unit with 1 2K storage 

• IBM 5444 Disk Storage Drive 

• IBM 5424 Multi-Function Card Unit or IBM 1442 Card 
Read Punch 



OPERATING CHARACTERISTICS 

Checkpoint/Restart depends on the System/3 Model 10 
Disk System SCP programming support and the System/3 
Model 10 Disk System Overlay Linkage Editor support of 
the OPTNS statement. 

Check point/ Restart requires that the system I PL pack 
scheduler workarea contain the additional tracks for a 
Roll-in/Roll-out area. This area is available if either the 
inquiry capability or the Check point/ Restart feature is 
included at system generation time. 



• IBM 5203 Printer 



Checkpoint/Restart — Introduction 53 



54 



SECTION 2. PROGRAM ORGANIZATION 



Checkpoint/Restart enables the user to restart a check- 
pointed program. Checkpoint is a means of recording 
the status of a problem program at certain intervals 
(checkpoints). After an error occurs. Restart can resume 
execution of a checkpointed program from the last check- 
point before the error. Restart is not allowed after a 
controlled cancel or normal end of job. 



CHECKPOINT 

Figure 21 shows an overview of Checkpoint. (An opera- 
tional diagram legend is included.) Figure 22 is the 
storage map. 

$$STKP (Checkpoint - Main Load) is entered from the 
supervisor as a result of a find and fetch request. Before 
a checkpoint can be made, $$STKP awaits completion of 
all pending non-tape I/O operations. Upon completion, 
$$STKP then gives control to $$STKQ (Checkpoint- 
Quiesce Magnetic Tape I/O) if tapes are used; otherwise, 
control goesto$$STKR (Checkpoint-Problem Program 
and SWA Load) to de-activate the checkpoint area and 
save the SWA and checkpointed program on disk. 
$$STKT (Checkpoint-Final Load) can be called to store 
the checkpoint information, then restore the check- 
pointed program and re-activate the checkpoint area. At 
this time the checkpointed program is given control to 
continue processing. 

If errors occur, control returns to the checkpointed pro- 
gram with a completion code of X'41 '. If an unrecover- 
able disk error occurs, control passes to the end-of-job 
transient, $$SPEJ. 

The position of tapes can be saved only if the tapes were 
opened and allocated by SCP support. Checkpoint 
modules use fields NPSCHA (set by ALLOCATE) and 
NPDTF@ (set by OPEN) in the program level 1 communi- 
cation region (N1COMN) to determine if tapes are used 
by the program and to save the following information 
from the DTFs: 

- Q-code 

- SWA Format 1 (F1) numbers 

- Current block count 



This information is used by RESTART to reposition the 
tapes. Checkpoint/Restart cannot reposition BTAM 
tape files or files accessed directly via tape IOS. 



CHECKPOINT LINKAGE 

To use Checkpoint, the checkpoint attribute (bit 1 of 
the second attribute byte) must be set in the object 
library directory entry for the program to be check- 
pointed. This attribute is set from the information in 
the object deck header card if the program is put in the 
object library by the Library Maintenance program. 
The checkpoint attribute is mutually exclusive with the 
inquiry invoking attribute. 

To call Checkpoint, the following linkage convention is 
required: 



LA 


FDPARM,2 


Pointer to find para- 
meter list 


B 


NCENTR 


General entry 


DC 


XLI'81' 


Find 


CLI 


0(,2),C'O' 


$$STKP FOUND? 


BE 


ERRTN 


NO, GO TO USER 
ERROR RTN 


MVC 05,1(2,2) 


Set up C/S for fetch 


B 


NCENTR 


General entry 


DC 


XLV80' 


Fetch 


CS DC 


CL2W 


C/S of $$STKP from 
object library into 
transient area 


DC 


XLT02' 


(three sectors) 


B 


CONTIN 


Return from $$STKP 


DS 


XL1 


Completion code 


RESTRT EQU 


# 


Restart entry point 
(Any setup/reposi- 


. 




tioning necessary to 


■ 




continue after 
RESTART) 


FDPARM EQU 


* 


Find parameter list 


DC 


CL7'0$$STKP' 


Object module $$STKP 


DC 


CLI'S' 


On system pack 


DS 


CL4 
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Linkage to Checkpoint is achieved by branching to the 
resident general entry routine, N ENTRY, through the 
resident communication vector NCENTR. (NENTRY is 
documented in the IBM System/3 Disk Systems System 
Control Program Logic Manual, SY21-0502.) This branch 
must be followed by a constant value, called the request 
indicator byte (RIB), identifying the Find transient, 
$$SPFN. $$SPFN finds Checkpoint, using the find para- 
meter list (FDPARM). The C/S address is set up for a 
fetch, and another branch is made to NENTRY with a RIB 
for requesting $$STKP. This is followed by the C/S 
address of the $$STKP and the module size (three 
sectors). 



The completion code should be checked to ensure that a 
valid checkpoint occurred. The checkpoint is ignored if an 
I/O error is outstanding on any of the supported and 
allocated devices. Valid return codes are X'40' (checkpoint 
taken) and X'4V (checkpoint ignored). 



Descriptive Phase Name— •- 

Functions +■ 

Branches -*- 

Input Data Areas »~ 

Output Data Areas — •- 

Routines Called *- 




Data Movement 

Control Flow 

Formal Phase Name 
(same as microfiche) 

i 

$$SMPL Chart MC 

Sample Job-Phase One 

• Reads user-modified input cards, one at a time 

♦ If// END 

COMMON 
MACOUT 



Flowchart Identification 




Entry Point START 



$$SGSUB 



AB 



External Routines - 
Substitute Processor 



Subroutine Flowchart Identification 
Chart ID - Routine is in this manual 



*2 



Routine is in IBM System/3 Disk 
Systems System Control Program 
Logic Manual, SY21 -0502 

Routine is in IBM System/3 Disk 
Systems Data Management and 
Input/Output Supervisor Logic 
Manual, SY21-0512 



I 



(Next Phase) 



Figure 21 (Part 1 of 5). Checkpoint Operational Diagram Legend 
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START 




i 



Enter from supervisor 

Result of find and fetch request 



$$STKP Chart BA Entry Point $$STKP 

Checkpoint - Main Load 

• Awaits completion of all non-tape pending I/O operations 
for the program level 

• Loads $$STKR (Checkpoint - Problem Program and SWA Load) 

• If tape is used, loads $$STKQ (Checkpoint - Quiesce Magnetic 
Tape I/O) ^^^h^m^^^^^^^^^h^^^^h 



♦ If an unrecoverable disk error occurs 



♦ If errors occur, sets completion code X'41 r 



3> 



CONFIG in SWA 



:> 



NCPL1 




NCSTOR in NCPL1 <^ I/O > Volume label on 

system pack 



Disk IOS *2 

Halt/Syslog *1 
$$STNQ *1 



For read, write, and wait 

To indicate checkpoint ignored 

Wait on program level 2 interlock 



T 



External Routines 



(Exits to ^v 
$$STKQ J 

(Exits to "N 
$$SPEJ J 

(Returns to check-^\ 
pointed program J 



$$STKR 



Figure 21 (Part 2 of 5). Checkpoint Operational Diagram Legend 
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$$STKQ Chart BB Entry Point $$STKQ 

Checkpoint-Quiesce Magnetic Tape I/O 

• Awaits completion of all pending magnetic tape I/O operations 
for the program level 

• Loads $$STKR (Checkpoint-Problem Program and SWA Load) 

• Ff errors occur, sets completion code X'41 ' ^^^^mm^m^^m 



r> N1C0MN \^> 



Opened DTFs (Tape) 
Tape information in NCSTOR 




NCPL1 



— External Routines 

Tape I OS *2 Wait 

Halt/Syslog *1 To indicate checkpoint ignored 



i 



Returns to 
^[ checkpointed 
program 



$$STKR 



• Figure 21 (Part 3 of 5). Checkpoint Operational Diagram Legend 
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$$STKR Chart BC Entry Point $$STKR 

Checkpoint - Problem Program and SWA Load 

• De-activates the checkpoint area 

• Writes the check pointed program region onto disk 

• Saves the SWA for the program level 

• Saves tape information passed to NCSTOR 

• Load$$STKT (Checkpoint- Final Load) 

• If an unrecoverable disk error occurs h^ni 




I/O 



SWA 



I/O > Volume label 
on system pack 




I/O 




< 



: External Routines 

Disk IOS *2 For read, write, and wait 



$$STKT 



N1COMN 



Table of entries 



Exits to 
$$SPEJ 



| Figure 21 {Part 4 of 5). Checkpoint Operational Diagram Legend 
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$$STKT Chart BD Entry Point $$STKT 

Checkpoint - Final Load 

• Stores information about system and program status 
for each of the following data areas: 

- Print chain image 

- Printer page size 

- Scheduler/data management switches 

- Volume labels 

- Program level communication region (N1COMN) 

- Tape repositioning information 

• Activates the checkpoint area 

• Restores user program that was overlaid as work area 

• Passes control to checkpoint program 

• If an unrecoverable disk error occurs ^^^^^^hm 



> NCPL1 z^> 



N1COMN 



=> 





Volume labels 
Table of entries 



I/O > Volume label 

on system pack 



— — — — External Routines — — — — — 



Disk I OS *2 

Halt/Syslog *1 



For read, write, and wait 

To indicate checkpoint accepted 



i 



(Exits to\ 
$$SPEJ J 



Return to check pointed 
program with completion 
code X'40' 



Figure 21 {Part 5 of 5). Checkpoint Operational Diagram Legend 



60 



> 



X'OO' 
X'0100' 



EOS (end of 
supervisor) 







■— 1 


r 




i 




1 


] Transient Area 




1 


I 




1 


I 




1 


User Storage* (used and restored during 


a checkpoint) 






Program Level /\ 1 


Only 





*Note: User's program must be at least 1 K since 
this is the minimum work area required. 

Figure 22. Main Storage Map Showing Transient Area and User Storage Needed by Checkpoint 
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♦ . .' 
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■>*IITH PBOG LEVEL* 
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AS 

i* 
QUIESD 



* * 1 

BSD 4 



•SATE HFCB SEHSE* 
• BITES • 



HOTE 1: 

see ibb srsrsH/3 

DISK SISTERS STSTEH 
COHTBOL PBOGBAK 



SEB IBB SY5TEB/3 
DISK SYSTEMS DATA 
BAS1GBBEUT AND INPUT/ 
OUTPUT SOPEBVISOB 



B3 



BAITD V SEE HOTE 2 



•DIODBT DISK* 
• BAIT * 



PASCBT * BA/02/AU 
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•UPCHTR • 
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• DPDATE * 

• CHECKPOINT • 
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015445 . . 
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.+ D1 *. 
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*. BOT 

*. CHECKED -• 
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+. .* 



POINT TO 5445 
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RESTART 

Figure 23 shows an overview of Restart. (An operational 
diagram legend is shown in Figure 21.) A storage map is 
given in Figure 24. 

$$RSTR (Restart - Main Load) is entered from the Super- 
visor as a result of // LOAD $$RSTR OCL statements. It 
checks for an active checkpoint and available storage. 
$$RSTR restores the SWA from the checkpoint disk area 
back to the system disk area. It also assures that the 
correct disks or tapes are mounted and cards or tapes are 
repositioned for any allocated and supported card de- 
vices (except 1442) or tape devices. 

If tapes are used, the files are repositioned to the block 
following the last block processed at the last checkpoint, 
provided the same reel is mounted. The filename and the 
tape drive are logged for each tape drive being processed 
to give the operator the opportunity to verify that the 
correct reel is mounted. Standard labeled tapes are checked 
to verify that the file label and volume sequence number 
match the reels being processed at the last accepted 
checkpoint. The nonstandard or unlabeled tapes are not 
verified. 

Basic access method files or direct calls to tape I OS are 
the responsibility of the user and no repositioning or 
label checking is done. 

Once this is done, $$STKV (Restart - Problem Program 
and Final Load} is loaded. 



$$STKV restores N1COMN and passes control to the 
checkpointed program. The restart entry point is at 
the last checkpoint taken. 

ff an immediate cancel or an unrecoverable disk error 
should occur, control is passed to the end-of-job tran- 
sient, $$SPEJ. 



RESTART LINKAGE 

To continue execution of the interrupted job at the last 
checkpoint the user must submit the following OCL state- 
ments to load Restart: 

// LOAD $$RSTR,unit 
//RUN 

The LOAD statement identifies the program to be run and 
indicates the disk on which it is located. For Restart, the 
unit must be the system I PL pack containing the checkpoint 
file to be restarted. The RUN statement indicates the end 
of the OCL statements, and the system runs the program. 
To guarantee the required minimum size for program 
level 2 (which must allow 5K for Restart in program level 1 ), 
a PARTITION statement may be required. Also, to re- 
establish the log device, a LOG statement may be required. 
For more information on these OCL statements, see IBM 
System/3 Model 10 Disk System Operation Control 
Language and Disk Utilities Reference Manual, GC21-7512. 



START 




Enter from Supervisor 

Result of // LOAD $$RSTR OCL 



$$RSTR Chart BE 

Restart - Main Load 



Entry Point $$RSTR 



• Checks for active checkpoint 

• Checks for available storage 

• Restores SWA from checkpoint disk area back to system disk 
area storage 

• Repositions cards in supported and allocated card devices 
(except 14421 

• Determines if correct disk packs are mounted 

• Determines if correct tapes are mounted and repositions 
the tapes 

• Loads $$STKV (Restart - Problem Program and Final Load) 

• If an unrecoverable disk error occurs v^^^^^vhm^^m 
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Figure 23 {Part 1 of 2). Restart Operational Diagram 
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$$STKV Chart BF Entry Point $$STKV 

Restart - Problem Program and Final Load 

• Restores N1COMN 

• Restores the checkpointed program 

• Passes control to the restored checkpointed program 

• If immediate cancel and unrecoverable disk error occur 
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Figure 23 (Part 2 of 2). Restart Operational Diagram 
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TBANSYEHT 



2 

OPTTOM 



BE/02/* 1 
•DT?*T0 • 



•DEACTIVATED 
• VOL LABEL 


STS* 

* 



• 002* 

* J1» 
■ a 

BOTE 1:* 

SET. IB(< STSTEB/3 
PTSK SySTEHS SY3TRH 
CONTROL PROGRAM 

roGic bmhhl 

SY21-0S02 



FSTRPF V BE/02/ 
t****B3*** ****** 

'DISKTO 



BEAD TABLE 
SECTOR 



C3 
. * * . 

.* * . 

*. npF 


IPS 


***** c n ********** 

•GBAB STORAGE IF* 
* P'CFSSAPY A«U • 




1 
1 

L 


•MINI-STASDBY YK* 
* PL2 • 




* NO 


1 
| 


DECOPE 

*****D3***« •*•*** 

• BESTOBF SWA 




V 
.*. 

DU *. 

. * *. 

yes . * has *. 

*. STORAGE .* 

*.»VATL»BLP.* 
*. . ■ 



P V BE/0?/ 
•***P3********« 

DISKTO 



PEAD TABLE 
SECTOR 



NCENTB TO 

FALT/ 

5* SLOG 



* SFT UP TO « 
•RPSTOBF, PPOG8&H" 

* conn begiow * 



**** 

* » 

• • 
**** v 

IB .* 

G3 



•***Pb *••••*••• 

' i 

FXIT to: ' 
*• *****•*•*•••* 

^FSPFJ 

«>H1-0»-JOS 

"■RVNSTENT 



vot rr 



*****H3* *•***»•• 
* 

* BESTOBE 

* SELECTFD 

* STORAPE AREAS 

**************** 



*****j 3 ********** 
•SET PROPBP LTSB* 

• CODNT IW • 

* PRIKTPB * 

• BEGIST^R * 

* * 
***************** 



• •** 

• * 

* K3 *-> 



>*** . 

TSIALC * 

*****jc3 ********** 

* PESTOBE FFCO * 
♦PRINT DATA PEG.* 
•AWD BEPOSinOH *- 

* CAHDS IF * 

* REQOTPBD * 
***************** 



CKVLAB 

•DISKIO 



■>* READ VOL ID 

* FBOtl SEI7CTFD 

* PACK 



CORP EC" 
PACK 



„ * 

*"na 



itfph 

*****BS ********** 
k * 

* SAVE PPOBtF.F • 
>* PROGRAH ARPA * 

* IH^O • 

* • 
***************** 



***•*!)***** ****** 



***************** 



* BF/03/P1 
•****p^**** ****** 

♦HJPSTT ♦ 

■>* C1ECK PEEL ID • 
*AHi> RPPnSTTTOH * 
• T R pr « 



* POTKT TO NFT-r 

* TAPP 



Li::*:' 



• no 



****flS< 

* * 

•NCPKT* PITH)* 

* AUD «E"PCH • 

* MP'KV ♦ 



' G1 ! 

*•*• 



V BE/02/D 1 ; 
»****J4 ********** 
*T11210 * 



**********< 



K<l *. 
.* EPBOB *. 
.* ON *. TPS 
■>*. BBPOSrTlOH -• 



♦ . .+ 
* HO 



j 8P/01/P2 
• ***j<^ ********* 

■FTTT TO: TSSTIfV* 



BB/02/AU 
*****K^********** 
•PRP * 



* CALL PFCO PBP * 

* • 
***************** 

I *•*• 
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ii****« 

ESTPH 



*************** 



****2)1 •*••*•*** 

SAVE BFTtJBll 

POITCT TO TWLINE 

CODE 

*************** 



10 7 SEE UOTE 2 
**C1********** 



7 SEP BOTE 2 
*****D1 ********** 



•DIODHT DT5F* 
♦ BATT • 



************ 



* SBT OP DNTT * 

* DISPLAY SITR * 

* ERBOSS » 

* • 
***************** 



■ i 

■ HALT 'R^* 



> i 

*************** 



•SETUP RFC LUG p* 
* BOFFPF ADI1R * 



SPE BO' 
•****C2********* 

* • 8JTNT2 * 

* * TFAKSIATE * 

* « LABEL TO * 
■ * EBCDIC * 
+ * * 
**************** 



****B2********< 
> BETDSD TO 
* CALLEH 



DBF, 

****P2*« ******* 

* * 

■-->* BETDHH TO KST * 

m * 

*************** 



»***F2*****i 
* ENTER 



HAITDS 

****£3****««**i 
■ 
♦ EHTFF 

****** *****~***i 



rllOOO 



' SAVF TP2 ANfl - 
■FFTOFH POTUT TO* 
' IHITBP. CODE * 
■ * 

***************** 



•****C3 ********** 

* * 

* SET 3P +0 • 
•DISPLAY TJBTT TH* 

* EBBOB * 

* • 
***************** 



SEE HOTF 
****D3**** ****** 

* KCFRTB * * 
♦HALT/SYSLOG* • 

* TO PBTUT * * 



IAI.T 9 SEE MOTE 1 

*****F3 ********** 

♦ * * * 

• * HCF*TR * » 

* *TTA1T/SYSI,0G* * 

* * BITR HALT * • 



***************** 



****P3 ********* 

• • 

• RFTORF TO NSJ * 



****f)T* ******** 
•DISPLAY OBTT B • 
• REASOD • 



**** 


*001* 


* J2 ♦->! 


• * \ 


**** 


50 FTC B ? 



«••*• 32* ********* 

* * 

* SAVE JB2 AMD * 
■RFTIIPB POllT TO* 

* IHLIBP. CODE • 



***************** 



CALERP V SEE BOTE 2 
*****fl 2* ********* 

• * * * 

• *S*CLE1 BFCO* * 

• * FBP * * 



***************** 



5F.T THHEDTATF 
CAHCEL 



**************** 



SEE SOTB 1 

****K1* ****** *• 
* 
BJCTT TO: • 

i * 

*************** 



CONTROLLED 
». CABCEt 



*»*•£ 2* ******** 

* * 

* 8FT0BH TO BSI ♦ 
■ * 

*************** 



*****j 3 ********** 

• • 

*SET C0BTB0L1.E0 * 

■>* CABCF.t * 



***************** 



•-->* J1 * 



J1 

**** 



MSPPJ 

EHD-DF-JOB 

TPASSTFJIT 



****^n********t 

* P.HTFB 



* **SBTAPI S.P.* * 

* "DilRTUT WAT** * 

* * OH * * 

* * OPFBATTOS * * 



COUTH OX ED 
■. CANCEL . 



• * NCBHTB • ♦ 

• *PBOGB LEVFT* * 

• *COflfl PPGTOH* * 

• * ADDS * * 

• * * * 
***************** 



***«fS********* 
PF.T"PK * 

■ 4 

TO: TNLTBB CODE 



■11210 

****DS********* 

* « 

* E1JTF.B « 



*************** 



•«**F4 ********* 

MCESTR LOAD* 
* MSPE.T * 



BOTE 1 

***«*GS«* ******** 

* * HCESTH TO * * 

* * LOG FILE * ■ 

* *HA«P/70I, ID* * 

* *. VIA * * 

* *F ALT/STL Or. * • 
***************** 



T1121R 

*****?■;*****••** 



FIND DETTCB 
TfALT CODF 



****njQ ********* 
r EXIT 



****r;<5 ********** 

* * • 

* HCENTR TO * * 

* F»[-T BTTH * • 

* OF-TT * * 

* * * 
**************** 



TO: S8SPFJ 



KOTF. 1; 

SB? IBM SYSTPH/3 

PISF SYSTBHS STSTFF 

CONTROL PBOGBAM 

LORTC I1AFHAL 

ST21-0SO2 



SEF TBB SYSTFH/3 
DISK SYSTBHS DATA 
HAWAGEMFKT ABD TFPOT/ 
OOTPOi 1 StTPEBVISOB 
LORTC MAUnAt- 
SY21-D512 



* 


OPTTOH 


*, 


YFS 




SFtBCTFD 




* , 


* 


* .* 


,* 


J 




*. . • 






• HO 

I 

I 




■ •*«* 
*004* 
• J2* 

• • 
• 



PESET SWTTCBES 
*************** 



****fr <;********• 

i < 

BF-nnHH < 
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r i 

**** 



***** 
* >■;* 



i1**«« 
P*TP!» 



STA8MRD 
LH6*L 
READ 



*TTim PI T* S»l • 

• FOB TAPE PILE • 

* IP PARB ITJT • 



T10U7? 



.* LEAD *. VPS 

'»>*- f|pp hurt .• 

•. READ .* I 



5ETDP fORBARD * 
SPAC? PTT.P * 

rPSP) 



* r>s * 
•• •• 



SETUP TO BKffTtrn 

(KE«> 



NOTP2 



i*gG*******«* 

* *1>t)'»1)T PQTNT* 

>• * tub-ps * 

* * PRP/'S* * 



•♦•* 
•00*1* 

* p3 ♦-> 

* ■ 
*• + * 

T10100 fr BE/02/15 

•*+**C1 *•**♦*.#.*•• 

•TH210 

•OOT^ffT'pTLsSuHE* 
*B FALT FOB VOL * 

* TO BE (!O0"TED • 



R10150 V 

••**»£1********i 



ASCTI *. '10 V • SP~ 

TII.P .* >• ftHLABPtED/NOH 

. • • STANDARD S5»D 



*t- 11000 • 



•v*TT OH Hpy/PSP* 



*•*• 

• noi» 

* os ♦-> 

110B'' < > ¥ 
V 



• S'TnP TO 

• POPBABP SPACE 

• PLOC* {*SB1 



'1»**»*«**< 

• * *.<BTAH * 

• *PgTFY POTNT* 

• * DHBTPS ♦ 

• *RE«ISD TUPP* 

• • • 



T1023? ¥ 



235 v 
£****P2*******< 



T10260 



SEE NOTE 2 
PAGE 2 OF 3 



BP/02/A1 
•****p^******a •*< 
•TllOOO 
■ 
•UAIT OH RPHINO 



>•. ffRLABEIET) .* 

•.specified.* 


- — >*. BRAI) 


*, , » 


*. . • 




*. .* 


* > * 


* HO 


• TTK 






i •••• 






1 * 






*.->* X3 












Tt»S*«* 


■ • • 


. * . 


P3 *. 


*U *. 


, » *. 


» *. 


.• •. T8S 


* *. 


*. SOHSTIlBTiAKO .* 


-->*. KONSTAHOARD , 


•.SPEC 


[PIED.* 


*. REAP .* 



NOTE 2 



•**8TA* E. P.* * 
•BBBTHS BEAD* * 
• 80-BlfTE * • 



BP/02/M 



• BAIT OX BEAD 



.•" TAP* *- TES 
*. HARK READ .* 



■***j2********* 



,•*****»•*****! 



5.1 



5PE NOTE 2 



• **5BTAP1 E.T. 
->* • PHPTAS 

• * (FSB1 

• • 
•**■•••**•■*•• 



• ••• 
■ • 

■>* CI • 











T10230 .*. 

K1 *. 




BE/02/A2 

**»«*|T2** •*••**•• 


. * *. 
.* ASCII •. 
•. PILE 

*. . • 


TES 


•T11300 0D2A2J 

--->* GO TBAHSLA'F • 
» BP-COBD TO • 
* EBCDIC 
«**•*•**•••**•*•* 


* WO 

1 




I 
I 


■ »•• 




* 

♦ **• 


* m 




* • 


• A2 • 

* * 




• A7 • 

* • 


■ < 


• • 




***» 



. * 
* YF5 



.•ODTPOTTlNrc *. 
*. ADDITTOKAl 
*. VOL .* 



• ••• 



r 



NO .* VOL I" •• NO 



• TES *••« 

* CI 



T10297 
Til] 3001 



i,j^*********« 

• * 

• i 
•PFSPi" SWT'CPPS » 

• • 

• * 
••••**•*«*•«*«**■ 



RF!THBK » 



***** 

• 00** 

♦ n2« 



TO: CAILPR 



»00<l* 
• P.1* 

* • 
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■* I 



■ ***• 
* F3« 



**** 
T103fi8 

*****A 2**+* ****** 

* * 

* SET NO PILE OH • 

* TAPE • 



***************** 



BF/0 2/AH 


Tioa^n 

• 
• 




**** ♦tiiooo 


• 
-• 

* 
* 


>*ji;******+** 


* *H * >* 

* * * VATT ON READ 
**** * 


S»fER 









T10365 



• SET0P TO HPAD • 
•R0-BYTE PPCORn • 



• fl2 •-> 



*•** 
T103B0 .•• 

B2 *. 

.•UNLABEL*. 

.• OS * 

■■>*.NON-STAHDAPD 

LABEL .< 



no 



r 



22 

*»»»33»« ***«*■•* 

SET »0 FDB2 



LABE1 

I 



* TAPE .* *. HORB 
*< HART*. COMPLETION .*- 

* *. CODS .* 



♦0003 
* If 3 

***** 



* Gtt * 

* * 
***» 



■ *** 
I * • 
L->« OH * 

* * 
*** • 



*JSBTAH E. P. 
*DHBTFW READ 



C2 



* * 

mom 

LEHG^H 
RECORD 

J 
■ *. 

cu *. 

'RECORD *. 
RO . *BT REQUEST *. 



BE/02/10 



a****Dl* ******** 
*T11000 



TlOUCi 



• BAIT OH READ 



**+* 

* 
' E3 *-> 

»**• 



HOftfl .* •. TAPE 

_,, cOdPLFTTOM ."HARE 

*. CODE .* 1 



TICM* V 

***** E2**« ****** 
•TIOS^D 



» COS7EBT FDR1 

* VOL SEQOBNCE 

• SO. TO BIKART 



• * 
■ ROffG 
LENGTH 
RECORD 



PI *. 

, *HPCORD *. 
•GT FEOOEST *. 

KASCIT 
*. FITE .* 



• A2 ' 

* i 
♦ *** 



« ASCTJ 
PILE 



T10B25 



« 1 

I* 



• SAVE REFORM 
•POTNT fO TSTIMi 

* CODE ASD XP1 



ASCTT 
FILE 



***** 
•003* 
* CI" 

• • 



REEL ID 
GTVBH 



9E/02/A2 



*****£(( ********* 
•T11300 



• GO TRAHSLATP 

• RECORD TO 

• EBCDIC 



****v£^ ********** 

•TNTTtALT.ZE LGTF* 
*r, BBF AFP* PST * 
* TO 1PYTE TO * 
*TE*T OP DEC SO • 



»**n<;********* 

CONVERT DECT HAT 

HnHFEH TO 

BTKHRY HtJMBEF 



****£5******4 
' FPTUFH TO 
CALLER 



.* FDR2 *. 
• 1ST *. 
H-CHARACTFRS .' 



■ E3 * 

* 
**** 



TO . 



AfiCTT 

ptlp 



♦ ADD OWE TO * 
•CONVERT NBHBFB * 



• * 

* <JU *-> 



T1DB30 



***** 
*O03* 
♦ AO* 



UN 

LABELED 

TAPE 



BE/C2/A2 



* GO TRANSIA^E 

* RECORD ""0 

* FBCDTC 



PROPER 
SEfiOENCE 



*. SO 



* Ui**H3********** 

* * 
♦ALLOH OPTIOF » 

■>•!(! HfcLT/STSLOG * 

* PARH LIST * 

* * 
***************** 



-*. NON-STANDARD 
TAPP .« 






•002* 
• H5 *-> 



**•*< 

♦003* 
* A5* 



** + * 
T10U19 

•****j2** ******** 



VOL 1ST *. TES 


* SFTHP TO BEAD * 
•BO-BTTE RECORD * 


3-CHAR .* 


. ACTERS .* | 


* * 


* * 


* NO *••• 






* * 






* ^1 * 






* • 






J 

• 






• ■ 


SEP HO 

■ 


F1 *. 


*****K2********** 


, * *. 


* * * • 


KDP1 ". VO 


* *«BTJH E.P.* • 


1ST H-CFAP .* 1 


♦ *DNBTRW PPAD* * 


ACTFH .* 1 


* * * * 


*. -• 


• * * • 


*. ." 7 




* TFS **** 


j 


**•* * « 

* * * E3 • 

L->» B2 * * * 




[ 


* 


* * *•** 


**** 


**** 


* * 




* J 


Ltt • 



**•* 




• 


* * 






• E3 • 

* * 
***• 




. *. 

J» *. 
.+ * 
HO .♦ HDR2 




V 

***** 


*. TAPE 
*. . * 




•003* 
* D5* 


* . . * 

« TES 



***** 
*003* 
* A5* 
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EE1DPP V 

•+***B1**«****««* 

* * 
•RESTORE PROGRAH* 

* COMHOSICATIOH * 

• REGION • 

• * 



•*»**£ 1*** ******* 
•SET CONTROLLED * 

• CANCEL IP • 

• REQUESTED BI • 

• SFCD EBP • 



■**»«B<t ********** 

• • 

• SfcVE BBT1JBR • 
•POINT TO INLINE* 

• CODE • 



7 SEE NOTE 2 



•DIODSP DISK* 
• IOS • 



" BF/01/A* 
•DISKIO • 

• BEAD PRO BLEB • 

• PROGBW • 

• * 



V SEE BOTE 2 



• *DIODHT DISK* • 

• • BAIT * • 



E1 



DPP 
• HO 



**«**22** ••••••• 

r 



■ SUABLE 
->*INTBHBOPT LEVEL 



SO 



•. NO 



■ . ABBOKHXL 



DNE 

»***g5*«»««**a* 

— >• RBTOBR TO NSI « 



*. COHTBOLLED 
*. CAHCEL . 



DOME 

**»*»G1 **«*■•■*» 

• SET OP TO 

• RBT1JRB TO 

• BESTABT EWTBT 

• POINT 



SEE BOTE 1 
BXXT TO: * 



SET (TP OMIT 
D I SPLIT 



IJSPBJ 

ERD-OP-JOB 

TBIBSIEKT 



HALT 'HE' 



***«r-|*«* **•*•' 

i 

» BUT TO: 



SEE IB ft SYSTEM/3 
DISK STSTBHS SYSTEB 
CONTROL PBOGRAB 
LOGIC BUSOAL 
ST21-0502 



BOTE 2; 

SEE IBB ST5TBB/3 
DISK STSTBHS DAT* 
BANiGEHEBT AND I (PUT/ 
OOTPOT SUPER 7ISOR 



•DISPLAY DNIT S 
• EteiSOB 



► SET IRREDIATB < 

► CANCEL 6 BO * 
►CHECKPOINT PBOG< 



ST21 



SEE BOTE 1 
EXIT TO: • 



SSSPBJ 

BND-OP-JO 
TRANSIENT 



Chart BF. Restart - Problem Program and Final Load ($$STKV) 
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X'0100' 








1 




j Transient Area 






I 


1 


EOS (End 






of supervisor) 


$$RSTR 




$$BTAM* 




$$RSTT 




$$RSTS 






(buffer area only, no 
flowchart) 




E0S+5K 





Load 
Module 

$$RSTR 



* See IBM System/3 
Disk Systems Data 
Management and input/ 
Output Supervisor 
Logic Manual, SY21-0512 



Figure 24. Main Storage Map Showing Transient Area and User Storage Needed by Restart 
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SECTION 3. DATA AREA FORMATS 



For a description of the following data areas, refer to IBM 
System/3 Disk Systems System Control Program Logic 
Afa/wa/,SY21-0502: 

• Configuration record (CONFIG) in the scheduler work 
area 

• Program level communications region (N1COMN) 

• System communication region (NCPL1) 

• Volume labels 



Volume Label 

The volume label of the system pack contains information 
about the checkpoint stored on the pack. The data is 
saved at: 



Decimal Disp 


Meaning 


185 


Bit = 1 Active checkpoint 


186 


Number of last checkpoint 
request {01-99) 



TABLE OF ENTRIES 



Checkpoint saves pointers to the saved data at each check- 
point taken in a table of entries. Restart uses this saved 
data to resume execution of a program at the last check- 
point. The address of the disk area in which the table of 
entries is located is contained in field NCR CSS in the 
system communication region. The format of the table of 
entries is shown In Figure 25. The possible entries are 
shown in Figure 26. 



Entry 
ID* 


Disk Address 
Where Stored 

(G/S/#r 


Displacement 
into Sector 


Length -1 
of Data 


Storage Location 
for Restore 



Number 1 
of Bytes 



*The following entry IDs may be used: 

X'10' - Storage information 

X'20' — Object program 

X'40' - Checkpoint parameter list 

X'C1' - 5445 Drive 1 

X'C9' - 5445 Drive 2 

X J A1' - 5444 Removable 1 

X'BV - 5444 Removable 2 



Figure 25. Table of Entries 
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The entries not required if missing are not in sector and other entries are shifted left and appear in 
order given. 



Required 1 
YES 

YES 
YES 
YES 



CO 




1X1 




cc 


NO 


\- 




z 




1X1 




LL 


NO 


O 




1X1 




-J 

CQ 


NO 


< 




1- 






NO 




NO 



YES 
YES 
YES 



10 


C S # 


Displacement 
into sector 


LNG-1 
of Prog 
Comm 

Region 


Program 
Communication 
@ (NCCOMN) 


10 


C S # 


Displacement 
into sector 





SCH/D.M. 
5445 Switches 

@ (NCSMV3) 


10 


C s # 


Displacement 
into sector 





SCH/D.M. 
5444 Switches 
@ (NCSMV1) 


10 


c s # 


Displacement 
into sector 


1 


Printer Page 
Size @ 
(NCRPSZ) 


C1 


c s # 


Displacement 
into sector 


5 


N/A 


C9 


c s # 


Displacement 
into sector 


5 


N/A 


A1 


c s # 


Displacement 
into sector 


5 


N/A 


B1 


c s # 


Displacement 
into sector 


5 


N/A 


10 


c s # 


Displacement 
into sector 


LNG-1 
of Chain 
Image 
(119) 


Chain Image 

@ 

(NCHIMG+119) 


40 


c s # 


Displacement 
into sector 


09 


N/A 


40 


c s # 


Displacement 

into sector 


15 


N/A 


20 


c s # 


N/A 


N/A 


Program 
Level 1 
Start @ 



LNG depends on 
dedicated or DPF 
System 



MFCU status, ARR, XR1, XR2, 
MFCU Print Data Register. 

Tape Repositioning 
Information * 



*The saved data for tape is 16 bytes, as follows: 

Number 11 2 11 2 

of Bytes 



60 

T1 


SWA 

F1 

Number 


Current 

Block # 


68 
T2 


SWA 

F1 

Number 


Current 
Block # 


70 
T3 


SWA 

F1 

Number 


Current 
Block # 


78 
T4 


SWA 

F1 
Number 


Current 
Block # 



The entries are left adjusted and any entries not required are X'00\ The entries are not necessarily in this order. 



Figure 26. Possible Table Entries 
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SECTION 4. DIAGNOSTIC AIDS 



APAR SUBMISSION 



DATA SAVED AT CHECKPOINT 



For APAR submission, the following information is 
necessary: 

• Contents of IAR and ARR. 

• Full core dump including the transient area. 

• Disk dump of the checkpoint area. The C/S/No. 
of sectors can be obtained from the core dump 
(Field NCRCSS of the System Communications 
region). 



The table of entries (described in Section 3) can be used 
to determine what information was saved at the last 
checkpoint. This information is used by RESTART. 

At each checkpoint, $$STKR and $$STKT build three 
sectors of data in the first three sectors of program level 
1. The first sector contains data to be saved and pointers 
to buffers and workareas. The second sector contains 
the table of entries (see Section 3. Data Areas) which 
points to the table information in the third sector. 



Disk dump of the program level 1 scheduler workarea, 
The C/S can be obtained from the core dump (Field 
NCSWRK of the System Communications region). 
The scheduler workarea is 48 sectors (2 tracks). 

Disk dump of the volume label of the system pack. 
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